खाते और प्रोजेक्ट तक पहुँच
अनुमत IP पते से सक्रिय API खाते का उपयोग HTTPS पर करें। प्रोजेक्ट उसी खाते का होना चाहिए और हटाया हुआ नहीं होना चाहिए। पोर्टिंग ऑर्डर की प्रक्रिया से मिला प्रोजेक्ट का विशिष्ट ID उपयोग करें, न कि डेटाबेस में उसका संख्यात्मक ID या कोई फ़ोन नंबर। अनुरोध बनाते समय प्रोजेक्ट ID को URL-एन्कोड करें।
अनुरोध
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"प्रतिक्रिया
काल्पनिक प्रतिक्रिया का उदाहरण।
{
"status": {
"code": 200,
"msg": "Project Numbers",
"results": 1
},
"response": [
{
"id": 21,
"number": "12025550123",
"status": 0,
"status_str": "Pending",
"isocode": "US",
"updated": "2026-10-23 12:00:00",
"foc": "",
"comment": "Example customer-visible note",
"date_created": "2026-10-23 12:00:00",
"date_completed": ""
}
]
}response एक सूची है। बिना नंबर वाला मौजूदा प्रोजेक्ट API कोड 200 और status.results का मान 0 रखते हुए खाली सूची लौटाता है। इसके विपरीत, मौजूद न होने वाले प्रोजेक्ट API कोड 404 लौटाते हैं।
नंबर के फ़ील्ड
| फ़ील्ड | अर्थ |
|---|---|
| id, number, isocode | पंक्ति का संख्यात्मक ID, सहेजा हुआ फ़ोन नंबर टेक्स्ट और देश का कोड। पंक्ति का ID प्रोजेक्ट का ID नहीं है। |
| status, status_str | संख्यात्मक स्थिति और उसका ज्ञात लेबल। |
| foc | अंतिम ऑर्डर प्रतिबद्धता की सहेजी हुई समय-निर्धारण वैल्यू। यह खाली हो सकती है; हैंडलर इसे किसी दस्तावेज़ित समय क्षेत्र या टाइमस्टैम्प प्रारूप में नहीं बदलता। |
| updated, date_created, date_completed | अपडेट, निर्माण और पूर्ण होने की सहेजी हुई वैल्यू। खाली वैल्यू को स्पष्ट रूप से संभालें; ISO8601 न मानें और काल्पनिक उदाहरण से समय क्षेत्र का अनुमान न लगाएँ। |
| comment | ग्राहक को दिखने वाली सहेजी हुई टिप्पणी। इसे टेक्स्ट के रूप में दिखाएँ, निष्पादन योग्य HTML के रूप में नहीं। |
लौटाई गई इस डेटा संरचना में केवल कर्मचारियों के लिए मौजूद internal_comment फ़ील्ड शामिल नहीं है। इसका अर्थ यह नहीं कि किसी एक नंबर की अलग पुरानी खोज भी इसी संरचना का उपयोग करती है।
क्रम और निगरानी
क्वेरी निर्माण समय के अनुसार बढ़ते क्रम में परिणाम देती है। समान निर्माण समय वाली पंक्तियों के लिए कोई अतिरिक्त क्रम सुनिश्चित नहीं है। पेजिनेशन, क्रमिक कर्सर या तारीख का फ़िल्टर नहीं है। प्रोजेक्ट के रिकॉर्ड मिलाने के लिए पूरी सूची पढ़ें और उसकी वर्तमान पंक्ति संख्या को स्थायी कैटलॉग न मानें।
पोर्टिंग स्थिति को समझें
| मान | लेबल |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
संख्यात्मक स्थिति रखें और अज्ञात मानों को भी संभालें। अज्ञात लेबल के लिए किसी नए सुनिश्चित लेबल के बजाय सहेजा हुआ मान उपयोग होता है। पूर्ण होने की सहेजी हुई स्थिति या निर्धारित तारीख अपने आप में इनबाउंड रूटिंग या नंबर की हर सेवा का परीक्षण नहीं है।
त्रुटियाँ और सीमाएँ
HTTP प्रतिक्रिया और status.code/status.msg दोनों जाँचें। गायब, हटाया हुआ या खाते के स्वामित्व में न होने वाला प्रोजेक्ट API कोड 404 के साथ प्रोजेक्ट न मिलने का संदेश लौटाता है। प्रमाणीकरण और स्रोत IP की पाबंदियाँ भी लागू हैं। उदाहरण कोई लाइव अनुरोध नहीं भेजते और सफल प्रतिक्रिया यह साबित नहीं करती कि कैरियर ने ट्रांसफर स्वीकार या पूरा कर लिया है।
प्रभाव
समीक्षित हैंडलर केवल प्रोजेक्ट और उसके नंबरों की सहेजी हुई पंक्तियाँ पढ़ता है। प्रतिक्रिया एक समय की स्थिति है, कैरियर की पुष्टि या लाइव सेवा परीक्षण नहीं। यह पोर्ट शुरू नहीं करती, रूटिंग नहीं बदलती और खाते से राशि नहीं काटती।