ثبوت کی اقسام کی فہرست دیکھیں

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

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

اصل تقاضوں کے مطابق ثبوت تیار کریں

کسی قسم کا فہرست میں شامل ہونا اس بات کا مطلب نہیں کہ وہ ہر ملک، نمبر کی ہر قسم یا ہر صارف کی شناخت کے تقاضے پورے کرتی ہے۔ ثبوت اپ لوڈ کرنے سے پہلے متعلقہ تقاضے پڑھیں، اور جواب میں ملنے والے شناخت کنندگان کو ایسی اقدار سمجھیں جن کی ساخت سے کوئی معنی اخذ نہیں کیے جاتے۔

درخواست

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

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

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

جواب

HTTP کی حیثیت کے ساتھ ساتھ JSON کے متن میں status.code بھی دیکھیں۔ response ایسے آبجیکٹس کی ایک صف ہے جن میں id، name اور entity_type شامل ہوتے ہیں۔ یہ اقدار ثبوت کی موجودہ فہرست سے آتی ہیں۔ شناخت کنندگان کی ساخت سے کوئی معنی اخذ نہیں کیے جاتے؛ انہیں خود بنانے یا ہیش کے ذریعے پیدا کرنے کے بجائے نقل کریں۔ ایک خالی فہرست بھی کامیابی کے ساتھ واپس آ سکتی ہے۔ اس مثال کی بنیاد پر اکائیوں کی تمام اقسام کی حتمی شمار شدہ فہرست کو کوڈ میں مستقل طور پر درج نہ کریں۔

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

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "PROOF_TYPE_ID_FROM_RESPONSE",
      "name": "Example proof category",
      "entity_type": "ENTITY_TYPE_FROM_RESPONSE"
    }
  ]
}

خرابیاں

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

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

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