کیٹلاگ میں شامل ممالک کی فہرست (پرانا فارمیٹ)

یہ پرانا اینڈ پوائنٹ جواب کا متن {"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 لفافے میں بھیجا جاتا ہے، پرانے فارمیٹ کے متن میں نہیں۔

دستیابی اور ضمنی اثرات

• صرف تلاش کی جاتی ہے۔ یہ نہ کوئی چیز ریزرو کرتا ہے، نہ آرڈر دیتا ہے اور نہ ہی کچھ تبدیل کرتا ہے۔