شناخت یا پتے کا ثبوت منسلک کریں

شناخت یا پتے کا ثبوت منسلک کریں

یہ مرحلہ اس وقت استعمال کریں جب شناخت یا پتہ موجود ہو اور اس کی مطلوبہ فائلیں اس ذریعے سے اپ لوڈ کی جا چکی ہوں: create_encrypt_files۔ اپ لوڈ کے لیے ثبوت کی منتخب کردہ قسم استعمال کریں۔ تازہ ترین شناخت کنندہ اس ذریعے سے حاصل کریں: get_proof_types، جو مطلوبہ شرط اور متعلقہ اکائی کے زمرے کے مطابق ہو۔

identity_id اور address_id محفوظ رکھیں، جو اس ذریعے سے ملتے ہیں: create_document؛ پروفائل کا UUID مختلف ہوتا ہے۔ نئے بنائے گئے پروفائلوں کے ساتھ بعد میں پتے کا ثبوت منسلک کرنے کی مطابقت ابھی زیرِ جائزہ ہے۔ اگر پتہ مسترد ہو جائے تو دوبارہ کوشش کرنے سے پہلے پورٹل پر جانچ کریں یا معاونت سے رابطہ کریں۔

ثبوت بنائیں

MultiTEL کا فعال API اکاؤنٹ اور اس کے لیے اجازت یافتہ آئی پی پتہ استعمال کریں۔ مثالوں میں ماحول کے متغیرات سے حاصل کردہ HTTP Basic کی اسناد استعمال کی گئی ہیں؛ اپنے اکاؤنٹ کی قسم کے لیے مقررہ توثیقی طریقوں کی پیروی کریں۔ درخواستیں HTTPS کے ذریعے بھیجیں۔ HTTP کے جواب اور JSON کے درج ذیل فیلڈ، دونوں کو جانچیں: status.code؛ ایپلیکیشن کی خرابیاں HTTP 200 کے ساتھ بھی موصول ہو سکتی ہیں۔ ذیل کی مثالیں فرضی ہیں۔

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data @proof-request.json \
  https://api.multitel.net/v3/create_proof

{
  "entity_type": "identities",
  "entity_id": "33333333333333333333333333333333",
  "proof_type_id": "11111111111111111111111111111111",
  "encrypted_file_ids": [
    "22222222222222222222222222222222"
  ]
}

فارم کا ڈیٹا بھی قبول کیا جاتا ہے، جس میں درج ذیل نام کے فیلڈز بار بار شامل ہوں: encrypted_file_ids[]۔ حقیقی JSON صف یا فارم کی صف کو ترجیح دیں؛ JSON میں انکوڈ کی گئی صف کو فارم کی عام واحد قدر کے طور پر نہ بھیجیں۔

ثبوت کا شناخت کنندہ محفوظ رکھیں

{
  "status": {
    "code": 200,
    "msg": "Proof created successfully."
  },
  "response": {
    "id": "44444444444444444444444444444444",
    "entity_type": "identities",
    "entity_id": "33333333333333333333333333333333",
    "proof_type_id": "11111111111111111111111111111111",
    "proof_type_name": "Example identity proof"
  }
}

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

خرابیاں اور میعاد ختم ہونے والی اپ لوڈ کردہ فائلیں

API کا کوڈ 500 مطلوبہ اندراجات کی عدم موجودگی، ٹیلی کام آپریٹر کی ناکامیوں اور آپریٹر کے غلط جواب کے لیے استعمال ہوتا ہے۔ کوڈ 404 اس وقت استعمال ہوتا ہے جب مطلوبہ اکائی موجودہ اکاؤنٹ سے منسلک نہ ہو، ثبوت کی قسم غلط ہو، اس اکاؤنٹ یا زمرے کے لیے اپ لوڈ کردہ فائل نہ مل سکے یا اس کی میعاد ختم ہو چکی ہو، یا فائلوں کے کوئی قابلِ استعمال شناخت کنندگان باقی نہ ہوں۔ یہ بھی پڑھیں: status.msg، کوڈ کے ساتھ۔

جس مطلوبہ فائل کی میعاد ختم ہو چکی ہو، اسے منسلک کرنے سے پہلے ثبوت کا درست زمرہ استعمال کرتے ہوئے دوبارہ اپ لوڈ کریں۔ اگر فراہم کردہ فائلوں میں سے کوئی بھی غلط ہو تو درخواست سنبھالنے والا یہ جزو ثبوت بنانے کی درخواست بھیجنے سے پہلے رک جاتا ہے۔ ایک ہی درخواست کی تکرار سے اضافی اثر کو روکنے کے لیے کوئی کلید دستیاب نہیں ہے: انتظار کی مہلت ختم ہونے کے بعد دوبارہ منسلک کرنے سے پہلے پورٹل میں موجود دستاویز کی جانچ کریں۔