رجسٹریشن کے تقاضے پڑھیں

ملک اور نمبر کی قسم منتخب کریں

رجسٹریشن کے لیے ملک منتخب کریں، پھر درج ذیل سے واپس ملنے والا نام استعمال کریں: get_document_number_types۔ یہ نام درج ذیل پیرامیٹر کی قدر کے طور پر بھیجیں: number_type، قسم کا شناختی کوڈ یا نمبروں کی تلاش کا کوئی عمومی زمرہ نہ بھیجیں۔

واپس ملنے والی ہدایات پڑھیں

شناخت یا دستاویزات سے متعلقہ طریقۂ کار کے لیے تقاضوں اور تعلقات کے شناختی کوڈ محفوظ رکھیں۔ یہ کال تقاضے واپس کرتی ہے؛ یہ آپ کی فائلوں کی توثیق نہیں کرتی اور نہ انہیں جمع کراتی ہے۔ واپس ملنے والی ہدایات اور منتخب نمبر کے لیے مخصوص تمام تقاضوں پر عمل کریں۔

خرابی کو استثنا نہ سمجھیں

غلط ملک یا ملک کے لیے رجسٹریشن کی دستاویزات درکار نہ ہونے سے متعلق خرابی میں دو حالتیں یکجا ہیں۔ یہ اس بات کا ثبوت نہیں کہ رجسٹریشن ضروری نہیں ہے۔ تلاش کی ناکامی یا خالی نتیجہ بھی کسی کسٹمر یا نمبر کی منظوری نہیں ہے۔ اگر نتیجہ واضح نہ ہو تو معاونت سے رابطہ کریں۔

درخواست

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

POST کے ساتھ application/json یا application/x-www-form-urlencoded استعمال کریں۔

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  --request POST \
  --header "Content-Type: application/json" \
  --data '{"country":"US","number_type":"Local"}' \
  "https://api.multitel.net/v3/get_requirements"

جواب

HTTP کی حیثیت کے ساتھ JSON کے متن میں status.code بھی دیکھیں۔ response تقاضوں کا ایک واحد ریسورس ہے جس میں id، type اور attributes شامل ہوتے ہیں، نیز relationships بھی، جب وہ واپس کیے جائیں۔ ریسورس اور تعلقات کے ڈیٹا میں موجود شناختی کوڈز کی اندرونی ساخت سے کوئی معنی اخذ نہ کریں۔ اختیاری restriction_message کے متن سے HTML ٹیگز ہٹا دیے جاتے ہیں؛ باقی مواد کو متن سمجھ کر برتیں، قابلِ اعتماد HTML سمجھ کر نہیں۔ درخواست سنبھالنے والا جزو تقاضوں کا پہلا ریسورس واپس کرتا ہے، اس لیے یہ نتیجہ اخذ نہ کریں کہ یہ جواب ایک مکمل فہرست ہے۔ خصوصیات اور تعلقات کی دستیابی ملک اور قسم پر منحصر ہے؛ مثال کوئی مکمل اور مقررہ ڈیٹا ساخت نہیں ہے۔

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

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "id": "REQUIREMENT_ID_FROM_RESPONSE",
    "type": "RESOURCE_TYPE_FROM_RESPONSE",
    "attributes": {
      "restriction_message": "Example country-specific instructions."
    }
  }
}

خرابیاں

• 400: ملک اور number_type کی توثیق ناکام ہوئی: دونوں لازمی قدریں فراہم کریں۔ توثیق کے متن میں وضع بندی شامل ہو سکتی ہے۔
• 400: Invalid country ISO or No country registration documents required.: یہ مبہم پیغام بذاتِ خود رجسٹریشن سے استثنا ثابت نہیں کرتا۔
• 400: Invalid number type: واپس ملنے والی قسم کا نام استعمال کریں۔ پرانے خرابی کے پیغام میں Global، Local، Mobile، National، Shared Cost اور Toll Free درج ہیں۔
• 500: Unable to load registration requirements for the specified country and number type.: تقاضے کامیابی سے واپس نہیں کیے جا سکے۔ بعد میں دوبارہ کوشش کریں یا معاونت سے رابطہ کریں۔

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

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