डेवलपर

GET/v3/get_document/{uuid}

पंजीकरण प्रोफ़ाइल पढ़ें

स्थानीय दस्तावेज़ UUID के आधार पर खाते की एक सक्रिय प्रोफ़ाइल पढ़ें।

इस पृष्ठ पर
  1. एक संग्रहीत प्रोफ़ाइल पढ़ें
  2. प्रोफ़ाइल के लिए अनुरोध
  3. प्रोफ़ाइल की प्रतिक्रिया
  4. लौटाए गए प्रोफ़ाइल फ़ील्ड
  5. प्रोफ़ाइल न मिलना और दोबारा प्रयास करना

एक संग्रहीत प्रोफ़ाइल पढ़ें

अपने खाते में UUID के आधार पर चुनी गई सक्रिय स्थानीय पंजीकरण प्रोफ़ाइल प्राप्त करें। इसमें प्रोफ़ाइल के वही सीमित फ़ील्ड मिलते हैं जो इस फ़ंक्शन से मिलते हैं: documents; यह दूरसंचार सेवा प्रदाता के सत्यापन को अद्यतन नहीं करता और न ही संलग्न प्रमाण लौटाता है।

प्रोफ़ाइल के लिए अनुरोध

अपने सक्षम MultiTEL API खाते और उसके अनुमत IP पते से प्रमाणीकरण करें। उदाहरणों में परिवेश चरों में संग्रहीत HTTP Basic क्रेडेंशियल का उपयोग किया गया है। HTTP प्रतिक्रिया और JSON के इस फ़ील्ड, दोनों की जाँच करें: status.code; केवल HTTP 200 प्रतिक्रिया मिलने से सफलता की पुष्टि नहीं होती। उदाहरणों के सभी मान काल्पनिक हैं।

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_document/$DOCUMENT_UUID"

DOCUMENT_UUID का मान response.uuid पर सेट करें, जो इस फ़ंक्शन से मिलता है: create_document, या documents से मिलने वाले response[].id का उपयोग करें। यहाँ identity_id, address_id, किसी प्रमाण की ID या फ़ोन नंबर का उपयोग न करें। अनुरोध के मुख्य भाग की आवश्यकता नहीं है।

प्रोफ़ाइल की प्रतिक्रिया

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "id": "11111111111111111111111111111111",
    "first_name": "Example",
    "last_name": "Person",
    "phone_number": "12025550123",
    "id_number": "",
    "birth_date": null,
    "company_name": "",
    "company_reg_number": "",
    "vat_id": "",
    "personal_tax_id": "",
    "description": "Example profile",
    "identity_type": "Personal",
    "postal_code": "00000",
    "city": "Example City",
    "address": "1 Example Street",
    "signature": "BASE64_PNG_SIGNATURE_DATA",
    "date_created": "2026-10-23 16:00:00"
  }
}

लौटाए गए प्रोफ़ाइल फ़ील्ड

लौटाए गए फ़ील्ड के इस चयन में शामिल हैं: id, first_name, last_name, phone_number, id_number, birth_date, company_name, company_reg_number, vat_id, personal_tax_id, description, identity_type, postal_code, city, address, signature और date_created।

संग्रहीत डेटा के अनुसार वैकल्पिक मान खाली या null हो सकते हैं। फ़ील्ड के इस पुराने चयन में email, देश चुनने वाले फ़ील्ड, identity_id, address_id, अपलोड की गई फ़ाइलों के संदर्भ, प्रमाणों की सूचियाँ और सत्यापन की स्थिति शामिल नहीं हैं। यह प्रमाण की स्थिति या पंजीकरण की स्वीकृति बताने वाला एंडपॉइंट नहीं है। लौटाए गए पहचान, संपर्क और हस्ताक्षर संबंधी डेटा को निजी मानें।

प्रोफ़ाइल न मिलना और दोबारा प्रयास करना

API कोड 404 के साथ यह संदेश मिलने पर: Failed, Not found इसका अर्थ है कि इस खाते और UUID से मेल खाने वाली कोई सक्रिय प्रोफ़ाइल नहीं मिली। खाते और पहचानकर्ता की जाँच करें और देखें कि प्रोफ़ाइल हटाई तो नहीं गई है। यह खोज किसी दूसरे खाते की प्रोफ़ाइल का खुलासा नहीं करती।

प्रोफ़ाइल सफलतापूर्वक पढ़ लेने से प्रमाण की स्वीकृति या नंबर के सक्रिय होने की पुष्टि नहीं होती। यदि प्रोफ़ाइल बनाने या संलग्नक जोड़ने के किसी अनुरोध का परिणाम अनिश्चित है और आप उसके बाद आगे बढ़ रहे हैं, तो स्थिति बदलने वाला कोई अन्य अनुरोध करने से पहले पोर्टल में दस्तावेज़ की जाँच करें।