एक खरीदे गए नंबर का विवरण पढ़ें

एक खरीदे गए नंबर का रिकॉर्ड और उसका सहेजा गया कॉन्फ़िगरेशन पढ़ें। यह ऑपरेशन inventory एंडपॉइंट के ऐरे के बजाय एक ऑब्जेक्ट लौटाता है।

अनुरोध

HTTPS के ज़रिए सर्वर पर API क्रेडेंशियल का उपयोग करें। उदाहरण क्रेडेंशियल को एनवायरनमेंट वैरिएबल से पढ़ते हैं; उनमें कोई काम करने वाले क्रेडेंशियल शामिल नहीं हैं। जाँचें: status.code को JSON बॉडी में और साथ ही HTTP स्टेटस को भी। ये पुराने हैंडलर एप्लिकेशन की त्रुटि के लिए हमेशा HTTP त्रुटि स्टेटस सेट नहीं करते।

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/numberinfo/12025550100"

आवश्यक पाथ सेगमेंट सहेजा गया अंतरराष्ट्रीय टेलीफ़ोन नंबर है, उसका UUID या कोई PBX एक्सटेंशन नहीं। यह हैंडलर किसी क्वेरी पैरामीटर या अनुरोध बॉडी का उपयोग नहीं करता।

प्रतिक्रिया

यह प्रतिक्रिया की संरचना का एक उदाहरण है, खाते का डेटा या मौजूदा मूल्य का कोटेशन नहीं।

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550100",
    "uuid": "NUMBER_UUID",
    "description": "Main reception",
    "isocode": "US",
    "config": {
      "uri": "sip:reception@example.com",
      "uri2": "",
      "uri3": "",
      "forward_destination": "",
      "sms_uri": "",
      "sms_forward_destination": ""
    },
    "features": {
      "voice": "1",
      "sms": "1",
      "mms": "0"
    },
    "status": {
      "capacity": {
        "assigned_channels": "2",
        "used_channels": "0",
        "overflow": "0",
        "overage_charge": "0.01"
      },
      "origination": {
        "origination_trunk_id": "ORIGINATION_ID",
        "origination_trunk_name": "ORIGINATION_NAME",
        "origination_country_iso": "US",
        "origination_continent_iso": "NA",
        "origination_continent_name": "North America"
      },
      "service_active": "1",
      "force_codec": "",
      "force_dtmf": ""
    },
    "billing": {
      "cnam": "0",
      "overflow": "0",
      "autorenew": "1",
      "persistent": "0",
      "date_created": "2026-01-01 00:00:00"
    },
    "price": {
      "setup_price": "0.00",
      "monthly_price": "1.00",
      "per_minute": "0.01",
      "free_minutes": "0",
      "remaining_minutes": "0",
      "perminute_charges": "0"
    },
    "needs_registration": "0",
    "vrating": "",
    "country_id": "COUNTRY_REFERENCE",
    "area_id": "AREA_REFERENCE",
    "provider_id": "OPAQUE_LEGACY_REFERENCE"
  }
}

जब तुलना inventory से की जाती है, तो यह एंडपॉइंट needs_registration, vrating, country_id, area_id, provider_id और price.perminute_charges भी लौटाता है। ये पुराने सहेजे गए मान हैं, पहचान की मंज़ूरी की कोई अलग प्रतिक्रिया नहीं। संदर्भ आईडी के आंतरिक अर्थ की व्याख्या नहीं करनी चाहिए; उपयुक्त डिस्कवरी प्रतिक्रिया के बिना इनसे डिस्कवरी URL न बनाएँ और न ही प्रदाताओं की मैपिंग का अनुमान लगाएँ।

कोई मेल खाता नंबर नहीं

यदि प्रमाणित खाते के लिए कोई मेल खाता, निरस्त न किया गया रिकॉर्ड नहीं मिलता है, तो JSON बॉडी में status.code 404 होता है और संदेश में number not found शामिल होता है। उसके अंत में दिए गए स्रोत-पंक्ति वाले प्रत्यय पर निर्भर न रहें। दोबारा प्रयास करने से पहले सहेजा गया नंबर और inventory जाँचें।

परिणाम का उपयोग करें

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