একটি সহায়ক নথি সংযুক্ত করুন

একটি টেমপ্লেটভিত্তিক সহায়ক নথি সংযুক্ত করুন

টেমপ্লেটের জন্য ব্যবহার করুন get_supporting_document_templates এবং আপনার অ্যাকাউন্টের মালিকানায় ইতিমধ্যেই থাকা একটি পরিচিতি ব্যবহার করুন। নথিটির ফাইল আপলোড করতে ব্যবহার করুন create_encrypt_files এবং আপলোডের জন্য নির্দিষ্ট করুন supporting_template_id। সাধারণ পরিচয় বা ঠিকানার প্রমাণের আপলোডগুলো আলাদা শ্রেণির এবং এগুলোর বিকল্প হিসেবে ব্যবহার করা যাবে না।

সহায়ক নথিটি তৈরি করুন

একটি সক্রিয় 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 @supporting-request.json \
  https://api.multitel.net/v3/create_supporting_document

{
  "identity_id": "33333333333333333333333333333333",
  "template_id": "55555555555555555555555555555555",
  "encrypted_file_ids": [
    "66666666666666666666666666666666"
  ]
}

অনুরোধের ক্ষেত্রসমূহ
ক্ষেত্র	অর্থ
`identity_id`	আপনার অ্যাকাউন্টের সঙ্গে যুক্ত পরিচিতির আইডি আবশ্যক। এই অনুরোধ নথিটিকে একটি পরিচিতির সঙ্গে সংযুক্ত করে, সরাসরি কোনো ঠিকানা বা টেলিফোন নম্বরের সঙ্গে নয়।
`template_id`	সহায়ক নথির টেমপ্লেট আইডি আবশ্যক; সহায়ক আপলোডের জন্য নির্বাচিত একই টেমপ্লেট ব্যবহার করুন। সংযুক্ত করার ক্ষেত্রটি হলো template_id, আর আপলোডের ক্ষেত্রটি হলো supporting_template_id।
`encrypted_file_ids`	ফেরত পাওয়া আপলোড আইডিগুলোর একটি খালি নয় এমন JSON অ্যারে আবশ্যক। প্রতিটি আপলোড বর্তমান অ্যাকাউন্টের মালিকানাধীন হতে হবে, সেটির মেয়াদ শেষ হওয়া চলবে না এবং সেটি supporting_documents শ্রেণির হতে হবে।

ফর্ম ডেটায় একাধিকবার ব্যবহৃত encrypted_file_ids[] ক্ষেত্রও গ্রহণ করা হয়। এই সংযুক্তিকরণ এন্ডপয়েন্টে ফাইলের বাইট পাঠাবেন না।

তৈরি হওয়া সহায়ক নথি

{
  "status": {
    "code": 200,
    "msg": "Supporting document created successfully."
  },
  "response": {
    "id": "77777777777777777777777777777777",
    "template_id": "55555555555555555555555555555555",
    "identity_id": "33333333333333333333333333333333",
    "template_name": "Example supporting template"
  }
}

এটি সহায়ক নথি তৈরি হওয়া নিশ্চিত করে, নিয়ন্ত্রক অনুমোদন বা নম্বর সক্রিয় হওয়া নয়। আপস্ট্রিম রিসোর্সে ব্যবহৃত ‘স্থায়ী’ শব্দটি সংরক্ষণের মেয়াদ বা মুছে ফেলার নীতি সম্পর্কে গ্রাহককে দেওয়া কোনো নিশ্চয়তা নয়।

ত্রুটি ও পুনরায় চেষ্টা

API কোড 500 বোঝায় যে প্রয়োজনীয় ইনপুট নেই, টেলিকম সেবাদাতার ত্রুটি হয়েছে অথবা সেবাদাতার প্রতিক্রিয়া অবৈধ। কোড 404 বোঝায় যে পরিচিতিটি অ্যাকাউন্টের সঙ্গে যুক্ত নয়, টেমপ্লেটটি অবৈধ, আপলোড অনুপস্থিত, মেয়াদোত্তীর্ণ বা ভুল শ্রেণির, অথবা ব্যবহারযোগ্য ফাইলের সমষ্টি খালি। পরীক্ষা করুন status.msg; শুধু HTTP 200 যথেষ্ট নয়।

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