رجسٹریشن کے لیے نمبر کی اقسام کی فہرست حاصل کریں

واپس ملنے والے نام کے ذریعے قسم منتخب کریں

ملک منتخب کرنے کے لیے یہ فہرست استعمال کریں: get_document_countries۔ واپس ملنے والی قسم کا نام اس فنکشن کو دیں: get_requirements۔ اقسام کی فہرست میں کسی قسم کا شناختی کوڈ، سابقے کا شناختی کوڈ، نمبر کا شناختی کوڈ یا ثبوت کے زمرے کا شناختی کوڈ نہیں ہے۔

گروپس کی تعداد دستیاب نمبروں کا ذخیرہ نہیں ہے

available_groups اس فہرست کی تلاش سے واپس ملنے والے گروپس کے ریکارڈ گنتا ہے۔ یہ خریداری کے لیے دستیاب فون نمبروں کی گنتی نہیں کرتا، ذخیرہ محفوظ نہیں کرتا اور اس بات کی ضمانت نہیں دیتا کہ فہرست نے بالائی ماخذ کے تمام صفحات حاصل کر لیے ہیں۔ متعلقہ نمبروں کے ذخیرے میں تلاش کریں اور قیمت کی پیشکش کا الگ سے جائزہ لیں۔

درخواست

HTTPS کے ذریعے اپنے فعال API اکاؤنٹ کی اسناد استعمال کریں۔ Basic توثیق اور فعال API اکاؤنٹ کے bearer ٹوکنز کی معاونت دستیاب ہے؛ اکاؤنٹ کی پابندیاں لاگو ہوتی ہیں۔

GET درخواست میں کسی بھی دستاویزی پیرامیٹر کو URL کے پاتھ میں شامل کریں۔

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_document_number_types/$COUNTRY_ISO"

جواب

JSON کے متن میں status.code کے ساتھ HTTP کی حیثیت بھی چیک کریں۔ response ایک صف ہے جس میں id، name اور available_groups شامل ہیں۔ name کو number_type کے طور پر استعمال کریں جب get_requirements کو کال کریں؛ اس کی جگہ id نہ بھیجیں۔ available_groups اس قسم کے لیے واپس ملنے والے گروپس کے ریکارڈ کی تعداد ہے، ٹیلی فون نمبروں کے ذخیرے کی گنتی یا تمام صفحات کا مکمل مجموعہ نہیں۔ جن اقسام کے لیے کوئی گروپ واپس نہیں ملتا، انہیں شامل نہیں کیا جاتا۔ ترجیحی ترتیب Local، Mobile، National، Toll Free، Shared Cost، Global ہے، جس کے بعد فہرست میں موجود دیگر نام آتے ہیں۔

جواب کی ساخت کی وضاحتی مثال؛ یہ اکاؤنٹ کا براہِ راست ڈیٹا یا قیمت کی موجودہ پیشکش نہیں ہے۔

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "NUMBER_TYPE_ID_FROM_RESPONSE",
      "name": "Local",
      "available_groups": 3
    }
  ]
}

خرابیاں

• 400: country is required: رجسٹریشن کے لیے ملک کا ISO کوڈ فراہم کریں۔
• 400: Invalid country ISO or no available DID registration country found: رجسٹریشن کی موجودہ فہرست سے ملک منتخب کریں؛ اس سے یہ ثابت نہیں ہوتا کہ کسی دستاویز کی ضرورت نہیں ہے۔

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

• فہرست یا تقاضوں کی یہ تلاش کوئی شناخت تخلیق نہیں کرتی، کوئی ثبوت اپ لوڈ نہیں کرتی، کوئی نمبر رجسٹر نہیں کرتی اور کوئی آرڈر نہیں دیتی۔
• فہرست کا کامیاب جواب آپ کی دستاویزات کی منظوری یا اس بات کی تصدیق نہیں ہے کہ منتخب کردہ نمبر فعال کیا جا سکتا ہے۔