नंबर पोर्टिंग परियोजना की स्थिति जाँचें

खाते और परियोजना तक पहुँच

अनुमत आईपी पते से HTTPS के माध्यम से किसी सक्षम API खाते का उपयोग करें। परियोजना उसी खाते की होनी चाहिए और हटाई गई नहीं होनी चाहिए। पोर्टिंग ऑर्डर की कार्यप्रक्रिया से प्राप्त परियोजना की विशिष्ट आईडी का उपयोग करें, उसकी संख्यात्मक डेटाबेस आईडी या किसी फ़ोन नंबर का नहीं। अनुरोध बनाते समय परियोजना की आईडी को यूआरएल-एन्कोड करें।

अनुरोध

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/lnp/project/$PROJECT_ID/status"

यह एंडपॉइंट अनुरोध की बॉडी, पृष्ठांकन या तारीख के फ़िल्टर को नहीं पढ़ता।

प्रतिक्रिया

प्रतिक्रिया का काल्पनिक उदाहरण।

{
  "status": {
    "code": 200,
    "msg": "Project Status"
  },
  "response": {
    "uniqueid": "PROJECT_EXAMPLE",
    "status": 2,
    "status_str": "Completed",
    "counts": {
      "total": 2,
      "pending": 0,
      "in_progress": 0,
      "completed": 1,
      "rejected": 1
    }
  }
}

बाहरी status.code API का परिणाम बताता है। इससे अलग response.status परियोजना की पोर्टिंग स्थितियों से निकाला गया सारांश है। दोनों को एक न समझें।

सारांश सभी नंबरों का परिणाम नहीं है

यदि किसी भी नंबर की स्थिति In Progress है, तो सारांश वही स्थिति चुनता है; ऐसा न होने पर क्रमशः Pending, फिर Completed, फिर Rejected को प्राथमिकता दी जाती है। किसी भी ज्ञात स्थिति से मेल न होने पर सारांश डिफ़ॉल्ट रूप से Pending होता है। इसलिए, जिस परियोजना में पोर्टिंग पूरी हो चुके और अस्वीकृत, दोनों तरह के नंबर हों, उसका सारांश Completed दिखाता है, जबकि उसमें अस्वीकृत नंबर अब भी मौजूद होते हैं।

पूरी परियोजना समाप्त हो गई है, यह तय करने से पहले हमेशा गणनाएँ और अलग-अलग नंबरों की सूची देखें। counts.total में परियोजना के नंबरों की हर पंक्ति शामिल होती है; अन्य गणनाएँ केवल चार ज्ञात स्थिति मानों को गिनती हैं और दूसरे मान मौजूद होने पर उनका योग कुल संख्या के बराबर नहीं भी हो सकता है। जिस परियोजना में कोई नंबर नहीं है, उसकी सभी गणनाएँ शून्य और सारांश Pending होता है।

पोर्टिंग की स्थिति को समझें

स्थिति का संख्यात्मक मान बनाए रखें और अज्ञात मानों को भी संभालें। अज्ञात लेबल के लिए संग्रहीत मान का उपयोग होता है; किसी नए लेबल की गारंटी नहीं होती। संग्रहीत पूर्णता स्थिति या निर्धारित तारीख अपने आप में इनबाउंड रूटिंग या उस नंबर की हर सेवा की जाँच नहीं करती।

त्रुटियाँ और सीमाएँ

इन दोनों की जाँच करें: HTTP प्रतिक्रिया और status.code/status.msg। परियोजना मौजूद न होने, हटाई गई होने या खाते के स्वामित्व में न होने पर, परियोजना नहीं मिली का संदेश और API कोड 404 लौटता है। प्रमाणीकरण और स्रोत आईपी संबंधी प्रतिबंध भी लागू होते हैं। उदाहरण कोई वास्तविक अनुरोध नहीं भेजते, और सफल प्रतिक्रिया इस बात का प्रमाण नहीं है कि किसी दूरसंचार सेवा प्रदाता ने नंबर स्थानांतरण स्वीकार कर लिया है या पूरा कर दिया है।

प्रभाव

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