कैटलॉग में शामिल देशों की सूची प्राप्त करें (पुराना प्रारूप)

यह पुराना एंडपॉइंट {"code", "data"} वाला मुख्य भाग मानक status/response आवरण के बजाय लौटाता है। यह विशेष नंबरों के कैटलॉग से जुड़े दृश्यमान देशों की सूची देता है और स्टॉक की जाँच नहीं करता।

नए एकीकरणों के लिए:

• उपयोग करें GET /v3/getcountries ताकि स्टॉक में नंबर वाले देशों को खोज सकें।
• उपयोग करें GET /v3/other/{isocode} ताकि देख सकें कि किसी देश में वास्तव में किस प्रकार के विशेष नंबर उपलब्ध कराए जाते हैं। यहाँ सूचीबद्ध किसी देश के लिए भी वहाँ खाली कैटलॉग लौट सकता है।

अनुरोध

आवश्यक: HTTP Basic प्रमाणीकरण या Bearer टोकन (प्रमाणीकरण और API प्रतिक्रियाएँ देखें)। प्रमाणीकरण विफल होने पर, खोज चलने से पहले मानक आवरण में HTTP 401 प्रतिक्रिया दी जाती है।

GET अनुरोध, बिना किसी पैरामीटर और बिना मुख्य भाग के।

curl --user "$API_USER:$API_PASSWORD" 'https://api.multitel.net/v3/countries'

प्रतिक्रिया

मानक आवरण के बिना पुराने प्रारूप का मुख्य भाग: {code: 200, data: [...]}. इसमें status ऑब्जेक्ट, msg या results फ़ील्ड नहीं होता। data में देशों की सूची होती है, जिसके क्रम की कोई गारंटी नहीं है। फ़ील्ड: countrycode ('+' के बिना कॉलिंग कोड), name, description (name के समान मान), isocode, latitude और longitude। इसमें is_mobile, sms_coverage या next_function फ़ील्ड नहीं होते। कोई देश तब सूचीबद्ध होता है जब वह दृश्यमान हो और विशेष नंबरों के कैटलॉग से जुड़ा हो। स्टॉक की जाँच नहीं की जाती, इसलिए सूचीबद्ध किसी देश में फ़िलहाल कोई नंबर उपलब्ध नहीं भी हो सकता है। यदि कोई भी देश इन शर्तों को पूरा नहीं करता, तो data का मान null होता है।

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

{
  "code": 200,
  "data": [
    {
      "countrycode": "33",
      "name": "France",
      "description": "France",
      "isocode": "FR",
      "latitude": "46.0000",
      "longitude": "2.0000"
    }
  ]
}

त्रुटियाँ

• 401: प्रमाणीकरण मौजूद नहीं है या विफल हो गया है। इसे HTTP status 401 के साथ मानक status/response आवरण में भेजा जाता है, पुराने प्रारूप के मुख्य भाग में नहीं।

उपलब्धता और अतिरिक्त प्रभाव

• केवल जानकारी खोजता है। यह कोई आरक्षण नहीं करता, कोई ऑर्डर नहीं देता और कुछ भी नहीं बदलता।