नंबर की पंजीकरण प्रोफ़ाइल सबमिट करें

सहेजी गई प्रोफ़ाइल और नंबर तैयार करें

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

सक्षम MultiTEL API खाते के कॉन्फ़िगर किए गए क्रेडेंशियल और IP प्रतिबंधों के साथ HTTPS पर उसका उपयोग करें। वह प्रोफ़ाइल जिसे हटाया नहीं गया है और वह खरीदा गया नंबर जिसे निरस्त नहीं किया गया है, दोनों आपके खाते के होने चाहिए।

1. एक पंजीकरण प्रोफ़ाइल बनाएँ या कोई मौजूदा प्रोफ़ाइल चुनें। create_document से मिले स्थानीय प्रोफ़ाइल के uuid को सँभालकर रखें; get_document उसी स्थानीय संदर्भ को id के रूप में लौटाता है।
2. दूरसंचार ऑपरेटर को सबमिट करने के लिए प्रोफ़ाइल में उसके सहेजे गए पहचान और पते के संदर्भ होने चाहिए। सबमिट करने से पहले आवश्यक प्रमाण और सहायक दस्तावेज़ उनके उपयुक्त कार्यप्रवाहों के ज़रिए संलग्न करें।
3. जाँचें कि नंबर और प्रोफ़ाइल संबंधित देश और नंबर पर लागू आवश्यकताओं को पूरा करते हैं। यह न मानें कि सहेजी गई प्रोफ़ाइल हर नंबर के लिए स्वीकृत है।

जोड़ने का अनुरोध सबमिट करें

curl --silent --show-error --request POST \
  --user "$API_USER:$API_PASSWORD" \
  --form-string document_uuid="$PROFILE_UUID" \
  --form-string service_description="Example customer support line" \
  https://api.multitel.net/v3/number_identity/12125550123

पथ में खरीदा गया टेलीफ़ोन नंबर होता है, उसका UUID, PBX एक्सटेंशन या पहचान ID नहीं। हैंडलर नंबर से अंकों के अलावा अन्य वर्ण हटा देता है। देश कोड सहित पूरा अंतरराष्ट्रीय नंबर इस्तेमाल करें। उदाहरण काल्पनिक है और उसकी जगह आपको अपना नंबर और सहेजी गई स्थानीय प्रोफ़ाइल का संदर्भ देना होगा।

मल्टीपार्ट अनुरोधों में सरणी के लिए onetime_files[] फ़ील्ड बार-बार दिए जाते हैं। Content-Type: application/json के साथ JSON अनुरोध भी स्वीकार किया जाता है; उसके गुण फ़ॉर्म पेलोड में मिला दिए जाते हैं। पथ में नंबर न दिए जाने पर पेलोड में number दिया जा सकता है। अस्पष्टता से बचने के लिए ऊपर दिखाए गए स्पष्ट पथ को प्राथमिकता दें।

जोड़ने और स्वीकृति के बीच अंतर समझें

HTTP परिणाम और JSON के status.code, दोनों पढ़ें। HTTP 200 के साथ भी JSON त्रुटियाँ मिल सकती हैं। दूरसंचार ऑपरेटर वाले अनुरोध की सफलता पर यह संदेश मिलता है: Address verification task created; awaiting carrier review. इस उदाहरण में काल्पनिक संदर्भ इस्तेमाल किए गए हैं।

{
  "status": {
    "code": 200,
    "msg": "Address verification task created; awaiting carrier review."
  },
  "response": {
    "number": "+12125550123",
    "did_id": "11111111111111111111111111111111",
    "document_uuid": "0123456789abcdef0123456789abcdef",
    "identity_id": "22222222222222222222222222222222",
    "address_id": "33333333333333333333333333333333",
    "address_verification_id": "44444444444444444444444444444444",
    "verification_status": "pending",
    "verification_reference": null,
    "requirement_id": "55555555555555555555555555555555",
    "registration_details_id": "8516ac99dc60603295de7bdb6a153530"
  }
}

प्रदाता से जुड़े पहचानकर्ता छिपाए गए संदर्भ हैं, ऐसे स्थानीय प्रोफ़ाइल ID नहीं जिन्हें एक-दूसरे की जगह इस्तेमाल किया जा सके। document_uuid वही स्थानीय प्रोफ़ाइल संदर्भ रहता है जो आपने सबमिट किया था। इस हैंडलर के दूरसंचार ऑपरेटर वाले निष्पादन पथ में registration_details_id उस स्थानीय संदर्भ को फिर से हैश करके बनाया जाता है; बाद के प्रोफ़ाइल या सबमिशन अनुरोधों में document_uuid की जगह इसका इस्तेमाल न करें।

कुछ आवंटित नंबरों में दूरसंचार ऑपरेटर के सत्यापन की प्रक्रिया बनाने के बजाय स्थानीय पहचान जोड़ी जाती है। उनका सफल परिणाम Identity associated. होता है और response सरणी खाली होती है। इससे न तो दूरसंचार ऑपरेटर की समीक्षा का कार्य बनता है, न ही स्वीकृति प्रमाणित होती है। पोर्टल में जोड़ने का एक नया कार्यप्रवाह है, जिसमें प्रदाताओं को संभालने का तरीका और दोबारा सबमिट करने की जाँच इस एंडपॉइंट से अलग हैं।

डुप्लिकेट कार्य बनाए बिना त्रुटियाँ संभालें

API कोड 400 नंबर या प्रोफ़ाइल संदर्भ न होने की स्थिति दर्शाता है। कोड 404 खाते के लिए प्रोफ़ाइल या नंबर उपलब्ध न होने या दूरसंचार ऑपरेटर की इन्वेंटरी में नंबर न होने की स्थिति दर्शाता है। कोड 422 पहचान या पते के संदर्भ न होने, विक्रेता की आवश्यकताओं या दूरसंचार ऑपरेटर के सत्यापन में अस्वीकृति की सूचना दे सकता है। कॉलबैक कॉन्फ़िगरेशन न होने पर 503 मिल सकता है और कार्य बनाने के दौरान संचार विफल होने पर 502 मिल सकता है। हर विफलता को एक जैसा मानने के बजाय संदेश और उपलब्ध requirement_diagnostics पढ़ें।

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

बाद में स्थानीय डेटाबेस का कोई ऑपरेशन विफल होने पर भी प्रदाता कार्य स्वीकार कर सकता है, और यह सहायक फ़ंक्शन सफलता बताने से पहले हर स्थानीय लेखन का परिणाम नहीं जाँचता। इस हैंडलर में क्लाइंट की ओर से इडेम्पोटेंसी पैरामीटर या डुप्लिकेट सबमिशन रोकने की व्यवस्था नहीं है। टाइमआउट, त्रुटि या अनिश्चित परिणाम मिलने के बाद पोर्टल में नंबर का पंजीकरण इतिहास जाँचें या दोबारा सबमिट करने से पहले सहायता टीम से संपर्क करें। केवल स्थानीय रिकॉर्ड न होने से यह प्रमाणित नहीं होता कि प्रदाता को कुछ भी नहीं मिला।

एकबारगी दस्तावेज़ संबंधी सीमा

हैंडलर onetime_files स्वीकार करता है और हर गैर-खाली स्ट्रिंग को दूरसंचार ऑपरेटर के एन्क्रिप्टेड-फ़ाइल संबंध में आगे भेजता है। यह स्वामी खाते के अपलोड रिकॉर्ड नहीं खोजता और न ही बाहरी छिपाए गए अपलोड ID को प्रदाता के फ़ाइल ID में बदलता है। ऑफ़लाइन ऑडिट में आगे भेजने का व्यवहार सत्यापित हुआ था, दूरसंचार ऑपरेटर के यहाँ सफलतापूर्वक फ़ाइल संलग्न होना नहीं।

यह न मानें कि create_encrypt_files से मिले फ़ाइल ID को इस फ़ील्ड में कॉपी करके एकबारगी अनुबंध का कार्यप्रवाह पूरा किया जा सकता है। जब किसी नंबर के लिए ये दस्तावेज़ आवश्यक हों, तो पोर्टल का उपयोग करें या MultiTEL से समर्थित पहचानकर्ता कार्यप्रवाह की पुष्टि करें। यह अभी भी API समीक्षा का अनसुलझा हिस्सा है, शुरू से अंत तक सत्यापित उदाहरण नहीं।

पंजीकरण जानकारी की सुरक्षा करें

केवल वही जानकारी और दस्तावेज़ सबमिट करें जिन्हें उस नंबर के लिए उपयोग करने का अधिकार आपके पास है। प्रोफ़ाइल और सत्यापन के संदर्भ सही खाते से जुड़े रखें और पूरे पंजीकरण पेलोड को लॉग करने से बचें। यह अनुरोध पहले के हर प्रमाण या सत्यापन को हटाता या बदलता नहीं है। दूरसंचार ऑपरेटर की समीक्षा, सक्रियण और डेटा को बनाए रखना अलग-अलग प्रक्रियाएँ हैं।