नंबर पोर्टिंग परियोजना की घटनाएँ पढ़ें

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

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

अनुरोध

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

प्रतिक्रिया

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

{
  "status": {
    "code": 200,
    "msg": "Project Events",
    "results": 1
  },
  "response": [
    {
      "id": 31,
      "subject": "Example project update",
      "event": "{\"type\":\"comment\",\"value\":\"Example update\",\"source\":\"Example source\"}",
      "type": "comment",
      "value": "Example update",
      "source": "Example source",
      "date_created": "2026-10-23 12:00:00"
    }
  ]
}

यदि कोई मौजूदा परियोजना घटनारहित है, तो प्रतिक्रिया में API कोड 200, एक खाली सूची और status.results का मान 0 मिलता है। परिणाम निर्माण समय के घटते क्रम में माँगे जाते हैं; समान समय वाले परिणामों के लिए कोई अतिरिक्त क्रम निर्धारण, पृष्ठांकन, कर्सर या तिथि फ़िल्टर नहीं है।

घटना के पेलोड को ध्यान से पढ़ें

id घटना की पंक्ति का संख्यात्मक पहचानकर्ता है, subject उसका संग्रहीत विषय है और date_created उसका संग्रहीत दिनांक/समय मान है। यह एंडपॉइंट मूल event स्ट्रिंग को यथावत रखता है और उसके type, value और source को डिकोड करने का भी प्रयास करता है। यदि पेलोड JSON ऑब्जेक्ट नहीं है या कोई प्रॉपर्टी अनुपस्थित है, तो उससे संबंधित पार्स किया गया फ़ील्ड एक खाली स्ट्रिंग होता है।

पेलोड किसी निश्चित एनम तक सीमित नहीं है और उसके साधारण पाठ वाले स्कीमा में होने की गारंटी भी नहीं है। स्रोत के पाठ को सत्यापित पहचान न मानें और घटना की सामग्री को एचटीएमएल के रूप में प्रस्तुत न करें। कच्ची घटनाओं को अधिकृत सर्वर-पक्षीय कार्यप्रक्रियाओं तक सीमित रखें और अधिकृत उपयोगकर्ताओं को केवल उपयुक्त पाठ दिखाएँ। इस एंडपॉइंट में कर्मचारियों और ग्राहकों के लिए घटनाओं की दृश्यता का अलग फ़िल्टर या सामग्री के संवेदनशील अंश छिपाने की व्यवस्था नहीं है।

इतिहास से डिलीवरी की गारंटी नहीं मिलती

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

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

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

प्रभाव

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