معاون دستاویزات کے سانچوں کی فہرست حاصل کریں

سانچوں کی فہرست دیکھیں

سروس کی جانب سے لوٹائے گئے سانچوں کی فہرست حاصل کرنے کے لیے پاتھ کا اختیاری ISO حصہ چھوڑ دیں۔ فہرست کو فلٹر کرنے کے لیے ملک کا ISO کوڈ فراہم کریں۔ فلٹر سانچے میں موجود ملک کے اشارے سے مطابقت تلاش کرتا ہے؛ یہ اشارہ نام سے اخذ کیا جا سکتا ہے اور خالی بھی ہو سکتا ہے۔

تقاضوں کی بنیاد پر سانچہ منتخب کریں

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

اگر کوئی سانچہ واپس نہ ملے

فلٹر شدہ فہرست خالی ہونے کا مطلب یہ ہو سکتا ہے کہ ملک کا کوئی مماثل اشارہ نہیں ملا۔ بغیر فلٹر کی فہرست خالی ہونا بالائی ماخذ سے ڈیٹا دستیاب نہ ہونے کی علامت بھی ہو سکتا ہے۔ ان میں سے کسی بھی نتیجے کو اس بات کا ثبوت نہ سمجھیں کہ کوئی معاون دستاویز درکار نہیں ہے۔

ڈاؤن لوڈ کی گئی نقل استعمال کرنے سے پہلے اس کا جائزہ لیں

فہرست میں موجود ڈاؤن لوڈ لنک سے ایسی نقل مل سکتی ہے جس کی وضع بندی یا برانڈنگ میں تبدیلیاں ہوں۔ یہ فرض نہ کریں کہ یہ اصل معاہدے کی بغیر تبدیلی والی نقل ہے یا اسے ڈاؤن لوڈ کرنے سے رجسٹریشن کا کوئی تقاضا پورا ہو جاتا ہے۔ کسی بھی دستاویز کو پُر کرنے یا اس پر دستخط کرنے سے پہلے اس کے مندرجات کا جائزہ لیں۔

جہاں پورٹل کا دستاویز تیار کرنے والا رہنما معاہدہ تیار کرنے کی سہولت فراہم کرے، وہاں اس کے پیش منظر اور واضح طور پر جمع کرانے کے عمل کو استعمال کریں۔ دیگر مطلوبہ فارموں کو پُر کرنے سے پہلے MultiTEL سے موجودہ فارم کی تصدیق کریں۔ ڈاؤن لوڈ کیا گیا سانچہ دستخط شدہ منسلکہ، اپ لوڈ کیا گیا ثبوت یا کسی نمبر کی منظوری نہیں ہے۔

درخواست

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_supporting_document_templates/$COUNTRY_ISO"

جواب

JSON باڈی میں status.code کے ساتھ HTTP کی حیثیت بھی چیک کریں۔ response ایسے آبجیکٹس کی صف ہے جن میں id، name، permanent، iso اور url شامل ہیں۔ permanent کی قسم boolean ہے؛ iso خالی ہو سکتا ہے اور ممکن ہے کہ اسے سانچے کے نام سے اخذ کیا گیا ہو۔ ملک کی معلومات کو ایک اشارہ سمجھیں، اہلیت کا فیصلہ نہیں۔ خالی فہرست ایک کامیاب 200 جواب ہے اور یہ اس وقت بھی مل سکتی ہے جب بالائی ماخذ میں تلاش سے کوئی ڈیٹا حاصل نہ ہو۔ URL سروس تیار کرتی ہے؛ اس کا ہوسٹ نام وضاحتی مثال سے مختلف ہو سکتا ہے۔

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

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "TEMPLATE_ID_FROM_RESPONSE",
      "name": "Example supporting-document template",
      "permanent": false,
      "iso": "US",
      "url": "https://api.multitel.net/v3/supporting_document/TEMPLATE_ID_FROM_RESPONSE"
    }
  ]
}

خرابیاں

• توثیق یا سروس کی خرابیوں کے لیے status.code اور status.msg چیک کریں۔ کامیاب جواب میں خالی فہرست ملنا کسی دستاویز کی منظوری یا رجسٹریشن سے استثنا نہیں ہے۔

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

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