পরিচয় বা ঠিকানার প্রমাণ সংযুক্ত করুন

পরিচয় বা ঠিকানার প্রমাণ সংযুক্ত করুন

এই ধাপ ব্যবহারের আগে পরিচয় বা ঠিকানা তৈরি থাকতে হবে এবং নির্বাচিত প্রমাণের ধরন অনুযায়ী প্রয়োজনীয় ফাইল আপলোড করতে হবে এই ফাংশনের মাধ্যমে: 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 কোডের সঙ্গে।

প্রয়োজনীয় কোনো ফাইলের মেয়াদ শেষ হয়ে গেলে সেটি সংযুক্ত করার আগে সঠিক প্রমাণের শ্রেণি ব্যবহার করে আবার আপলোড করুন। দেওয়া ফাইলগুলোর কোনোটি অবৈধ হলে এই হ্যান্ডলার প্রমাণ তৈরির অনুরোধ পাঠানোর আগেই থেমে যায়। একই অনুরোধ পুনরাবৃত্তি করলেও ফল অপরিবর্তিত রাখার কোনো চাবি দেওয়া হয় না: অনুরোধের সময়সীমা পেরিয়ে গেলে আবার সংযুক্ত করার আগে পোর্টালে বিদ্যমান নথিটি পরীক্ষা করুন।