---
title: 'पुन: उपयोग योग्य दस्तावेज़ प्राप्त करें'
description: 'नया कैप्चर फ़्लो शुरू करने से पहले जाँचें कि उपयोगकर्ता के पास पहले से पुन: उपयोग योग्य दस्तावेज़ उपलब्ध है या नहीं।'
canonical: https://developer.unico.io/hi/dual-api/developers/api-reference/api/get-document
locale: hi
generated_by: markdown-export
---

- [/hi/](/hi/)
- [API संदर्भ](/hi/dual-api/developers/api-reference/)
- [API](/hi/dual-api/developers/api-reference/api/)
- Get Reusable Documents

**इस पेज पर# पुन: उपयोग योग्य दस्तावेज़ प्राप्त करें

नया Document कैप्चर फ़्लो शुरू करने से पहले यह जाँचने के लिए इस एंडपॉइंट का उपयोग करें कि उपयोगकर्ता के पास पहले से पुन: उपयोग के लिए कोई दस्तावेज़ उपलब्ध है या नहीं। यदि कोई दस्तावेज़ मिलता है, तो कैप्चर चरण को छोड़ने के लिए उसका `documentId` सीधे `POST /processes/v1` (Document प्रकार) में पास किया जा सकता है।
### एंडपॉइंट​

वातावरणURL**Production**`GET https://api.id.unico.app/documents/v1`**Sandbox**`GET https://api.id.uat.unico.app/documents/v1`
### अनुरोध​

हेडर
हेडरमान`Authorization``Bearer <access_token>` (देखें [प्रमाणीकरण](/hi/dual-api/developers/api-reference/authentication))`APIKEY`दस्तावेज़ कैप्चर और पुनरुपयोग सक्षम किया गया प्रावधानित API कुंजी।
क्वेरी पैरामीटर
पैरामीटरप्रकारआवश्यकविवरण`code`stringहाँउपयोगकर्ता पहचानकर्ता (CPF या CURP, बिना फ़ॉर्मेटिंग के)।`type`stringहाँक्वेरी करने के लिए दस्तावेज़ प्रकार। स्वीकृत मान: `BR_RG`, `BR_CNH`, `BR_CIN`, `BR_PASSPORT`।
नोटऊपर दिए गए `type` मान केवल इस एंडपॉइंट के लिए विशिष  ्ट हैं। इन्हें निम्नलिखित से भ्रमित न करें:
POST अनुरोधों में `subject.duiType` — `DUI_TYPE_*` उपसर्ग का उपयोग करता है और व्यक्ति की पहचान करता है, दस्तावेज़ प्रकार की नहीं (उदा., `DUI_TYPE_BR_CPF`)।
प्रतिक्रिया में `documentType` — पूर्ण रजिस्ट्री पथ का उपयोग करता है (उदा., `unico.moja.dictionary.br.cnh.v2.Cnh`)।

### उदाहरण​

cURLNode.js```
curl -X GET "https://api.id.unico.app/documents/v1?code=12345678909&type=BR_CNH" \  -H "Authorization: Bearer $TOKEN" \  -H "APIKEY: $API_KEY"
```

```
import fetch from 'node-fetch';const params = new URLSearchParams({ code: '12345678909', type: 'BR_CNH' });const res = await fetch(  `https://api.id.unico.app/documents/v1?${params}`,  {    headers: {      Authorization: `Bearer ${accessToken}`,      APIKEY: apiKey    }  });const data = await res.json();// data.items[0].documentId → pass to POST /processes/v1 for reuse
```

### प्रतिक्रियाएँ​

200 OK
```
{  "items": [    {      "documentType": "unico.moja.dictionary.br.cnh.v2.Cnh",      "documentId": "doc-abc-123"    }  ]}
```

फ़ील्डप्रकारविवरण`items`arrayउपयोगकर्ता के लिए मिले पुन: उपयोग योग्य दस्तावेज़ों की सूची। यदि दिए गए `code` और `type` के लिए कोई पुन: उपयोग योग्य दस्तावेज़ नहीं मिला तो खाली array।`items[].documentType`stringदस्तावेज़ प्रकार पहचानकर्ता। संभावित मान: `unico.moja.dictionary.br.rg.v2.Rg`, `unico.moja.dictionary.br.cnh.v2.Cnh`, `unico.moja.dictionary.br.cin.v1.Cin`, `unico.moja.dictionary.br.passaporte.v1.Passaporte`।`items[].documentId`stringदस्तावेज़ पहचानकर्ता। दस्तावेज़ का पुन: उपयोग करने के लिए `POST /processes/v1` में `document.documentId` में यह मान पास करें।
### पुन: उपयोग के लिए documentId का उपयोग​

`documentId` प्राप्त करने के बाद, कैप्चर को छोड़ने के लिए इसे Document प्रोसेस अनुरोध में पास करें:
```
{  "subject": {    "code": "12345678909",    "name": "Luke Skywalker"  },  "document": {    "purpose": "onboarding",    "authProcessId": "<biometric-process-id>",    "documentId": "doc-abc-123"  }}
```

फ़ील्डविवरण`document.purpose`इस दस्तावेज़ प्रोसेस का व्यावसायिक उद्देश्य। स्वीकृत मान: `creditprocess`, `carpurchase`, `paybypaycheck`, `onboarding`, `fgts`। ये मान Document API के लिए विशिष्ट हैं और बायोमेट्रिक SDK के `purpose` enum से भिन्न हैं।`document.authProcessId`इस उपयोगकर्ता के लिए पहले बनाए गए बायोमेट्रिक प्रोसेस का ID (`POST /processes/v1` से)।`document.documentId`इस एंडपॉइंट की प्रतिक्रिया से प्राप्त दस्तावेज़ ID। यह प्रदान किए जाने पर, `document.files` को छोड़ा जा सकता है — प्लेटफ़ॉर्म स्वचालित रूप से पहले कैप्चर किए गए दस्तावेज़ को पुनः प्राप्त करता है।
पूर्ण Document प्रोसेस अनुरोध स्कीमा के लिए, देखें [Document प्रोसेस बनाएँ](/hi/dual-api/developers/api-reference/api/post-processes-document)।
### त्रुटि कोड​

400 Bad Request403 Forbidden404 Not Found429 Too Many Requests500 Internal Server Errorकोडसंदेशविवरण`20507`O parâmetro subject.code é inválido.गलत प्रारूप या गैर-मौजूद पहचानकर्ता मान (CPF या CURP)।`20002`O parâmetro APIKey não foi informado.APIKEY हेडर अनुपस्थित।`20001`O parâmetro authtoken não foi informado.प्रमाणीकरण टोकन हेडर अनुपस्थित।Bearer टोकन या `APIKEY` अनुपस्थित, समय-सीमा समाप्त, या अमान्य है।कोडसंदेशविवरण`30020`The provided authorization token does not have permission to perform this action.टोकन के पास दस्तावेज़ सेल्फ़ी तक पहुँचने की अनुमति नहीं है।`30017`User does not have permission to perform this action.गलत प्रारूप JWT या उपयोगकर्ता के पास यह ऑपरेशन करने की अनुमति नहीं है।`10502`O token informado está expirado.समय-सीमा समाप्त एक्सेस टोकन।`10501`O token informado é inválido.अमान्य प्रमाणीकरण टोकन।`10201`O AppKey informado é inválido.अनुपस्थित या गैर-मौजूद APIKEY।कोडसंदेशविवरण`99987`Attachment not found.दस्तावेज़ से संबंधित अनुलग्नक नहीं मिला।`50001`The process is not found.प्रदान किए गए पैरामीटर के लिए कोई दस्तावेज़ नहीं मिला।रेट लिमिट पूरी हो गई। जब आपका सिस्टम HTTP 429 त्रुटि प्राप्त करता है, तो आपको कैस्केडिंग विफलताओं को रोकने और प्रतिबंध को बढ़ने से बचाने के लिए तंत्र लागू करने होंगे।
**सर्वोत्तम प्रथाएं:**

**कूल-डाउन अवधि (backoff):** अपने सिस्टम से आ  ने वाले बाद के अनुरोधों को तुरंत रोकें या कम करें। विफल अनुरोधों को लगातार एक तंग लूप में पुनः प्रयास न करें।
**कतार और थ्रॉटलिंग (Queueing & throttling):** ट्रैफ़िक प्रवाह को नियंत्रित करने के लिए अपनी तरफ से आउटगोइंग अनुरोधों को बफ़र या कतार में रखें और फिर उन्हें पुनः भेजें।
**एक्सपोनेंशियल बैकऑफ़ विद जिटर (Exponential backoff with jitter):** पुनः प्रयास करते समय, प्रयासों के बीच प्रतीक्षा समय को तेजी से बढ़ाएं (उदा., 1 s, 2 s, 4 s, 8 s) और एक छोटा यादृच्छिक विलंब ("jitter") जोड़ें ताकि हर्ड इफ़ेक्ट से बचा जा सके जहां सभी कतार में रखे गए अनुरोध ठीक उसी मिलीसेकंड पर पुनः प्रयास करते हैं।

चेतावनीबैकऑफ़ लागू किए बिना रेट-लिमिटेड एंडपॉइंट को लगातार हिट करना **प्रतिबंध अवधि को बढ़ा** सकता है और आपके सिस्टम के परिचालन थ्रूपुट को गंभीर रूप से प्रभावित कर सकता है। अपनी तरफ से अनुरोधों को ठीक से थ्रॉटल करना एक सहज और अधिक लचीला एकीकरण सुनिश्चित करता है।
डिफ़ॉल्ट सीमाओं, अनुरोध बढ़ाने और अतिरिक्त विवरण के लिए, देखें [रेट लिमिट](/hi/dual-api/developers/api-reference/rate-limits)।कोडसंदेशविवरण`99999`Internal failure! Try again later.सर्वर-साइड प्रोसेसिंग त्रुटि।अंतिम अपडेट 8 अक्टू॰ 2026** को