নিবন্ধন প্রোফাইল হালনাগাদ করুন

প্রোফাইলের সম্পাদনাযোগ্য তথ্য প্রতিস্থাপন করুন

অ্যাকাউন্টের মালিকানাধীন বিদ্যমান নিবন্ধন প্রোফাইল হালনাগাদ করতে সেটির স্থানীয় UUID ব্যবহার করুন, যার উৎস হলো create_document অথবা documents। এই কার্যক্রম অ্যাকাউন্ট ও আপস্ট্রিম ক্যারিয়ারের তথ্য পরিবর্তন করে। এটি সংরক্ষিত Personal/Business পরিচয়ের ধরন পরিবর্তন করে না এবং এটি কিছু ফিল্ডের আংশিক PATCH নয়।

হালনাগাদের অনুরোধ

অনুমোদিত IP ঠিকানা থেকে আপনার সক্রিয় MultiTEL API অ্যাকাউন্ট দিয়ে প্রমাণীকরণ করুন। উদাহরণগুলোতে এনভায়রনমেন্ট ভেরিয়েবলে রাখা প্রমাণীকরণ তথ্য এবং কাল্পনিক তথ্য ব্যবহার করা হয়েছে। HTTP প্রতিক্রিয়ার পাশাপাশি JSON-এর status.code ও status.msg পড়ুন।

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data @registration-profile-update.json \
  "https://api.multitel.net/v3/update_document/$DOCUMENT_UUID"

{
  "first_name": "Example",
  "last_name": "Person",
  "phone_number": "12025550123",
  "email": "end-user@example.com",
  "city": "Example City",
  "postal_code": "00000",
  "address": "1 Example Street",
  "country": "US",
  "nationality": "US",
  "signature": "BASE64_PNG_OF_THE_AUTHORIZED_END_USER_SIGNATURE",
  "id_number": "",
  "personal_tax_id": "",
  "birth_date": "",
  "description": "Example profile",
  "company_name": "",
  "company_reg_number": "",
  "incorporation_country": "",
  "vat_id": "",
  "address_description": ""
}

উদাহরণে একটি Personal প্রোফাইল দেখানো হয়েছে; এর বদলে শেষ ব্যবহারকারীর কাঙ্ক্ষিত সম্পূর্ণ তথ্য ও অনুমোদিত স্বাক্ষর দিন। তথ্য অক্ষুণ্ণ রাখার উপায় হিসেবে নমুনা স্বাক্ষর বা খালি মান জমা দেবেন না। JSON ও ফর্ম-এনকোড করা ইনপুট সমর্থিত।

হালনাগাদের ফিল্ডগুলোর শর্ত
ফিল্ড	আচরণ
first_name, last_name, city, postal_code, address	আবশ্যক; প্রতিটিতে সর্বোচ্চ 64 অক্ষর।
phone_number	অন্তত আট অক্ষরের সংখ্যাসূচক মান আবশ্যক; দেশের কোডসহ আন্তর্জাতিক অঙ্ক ব্যবহার করুন।
signature	আবশ্যক। পোর্টাল ডেটা URL প্রিফিক্স ছাড়া Base64 PNG বাইট সরবরাহ করে।
country	নিবন্ধন ক্যাটালগ থেকে ঠিকানার দেশের ISO কোড দিন। হ্যান্ডলার কোডটি থেকে সংশ্লিষ্ট দেশ নির্ধারণ করে, যদিও পর্যালোচিত ঠিকানা হালনাগাদ প্রক্রিয়া দেশের সঙ্গে সম্পর্কটি পরিবর্তন করে না।
nationality	বিদ্যমান Personal প্রোফাইলের জন্য দেশের ISO কোড আবশ্যক।
company_name, incorporation_country	বিদ্যমান Business প্রোফাইলের জন্য আবশ্যক; কোম্পানির নামে সর্বোচ্চ 64 অক্ষর এবং কোম্পানি গঠনের দেশের জন্য ISO কোড দিতে হবে।
email	সর্বোচ্চ 254 অক্ষরের বৈধ ইমেইল ঐচ্ছিক। সংরক্ষিত যোগাযোগের ইমেইল অক্ষুণ্ণ রাখতে এটি বাদ দিন; স্থানীয়ভাবে মুছে ফেলতে খালি মান পাঠান।
id_number, personal_tax_id, birth_date, description, company_reg_number, vat_id	কাঙ্ক্ষিত বর্তমান মানগুলো পাঠান। বাদ দেওয়া মানগুলো ডিফল্টভাবে খালি হয় এবং বিদ্যমান সংরক্ষিত মান প্রতিস্থাপন করতে পারে।

দেশভিত্তিক নিবন্ধন বিধিতে অতিরিক্ত তথ্য বা বিন্যাসের প্রয়োজন হতে পারে। সম্পূর্ণ হালনাগাদ পুনর্গঠনের জন্য শুধু এই উৎসের ওপর নির্ভর করবেন না: get_document; এর সীমিত প্রতিক্রিয়ায় দেশ নির্বাচনের ফিল্ড, email ও সত্তার ID থাকে না। আপনার অনুমোদিত মূল তথ্য সংরক্ষণ করুন অথবা পোর্টালের নথি সম্পাদক ব্যবহার করুন।

উন্নত সেটিংস: আগে আপলোড করা প্রমাণপত্র যোগ করুন

ঐচ্ছিক identity_encryptfiles ও address_encryptfiles অ্যারেতে অ্যাকাউন্টের মালিকানাধীন সক্রিয় রেফারেন্স দেওয়া যায়, যার উৎস হলো create_encrypt_files। আপলোডের সত্তার শ্রেণি মিলিয়ে নিন এবং রেফারেন্সের মেয়াদ শেষ হওয়ার আগে জমা দিন। একাধিক ফাইলের প্রমাণের ধরন একই হলেও প্রতিটি ফাইল আলাদা প্রমাণপত্রের অনুরোধে সংযুক্ত হয়। একাধিক ফাইলবিশিষ্ট পরিচয়ের প্রমাণপত্রের জন্য পরবর্তী ধাপের প্রমাণপত্র সংযুক্তির কর্মপ্রবাহে একটি অ্যারে ব্যবহার করুন।

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

সাফল্য ও ব্যর্থতার পুরোনো প্রতিক্রিয়া

{
  "status": {
    "code": "success",
    "msg": "Successfully Saved."
  },
  "response": ""
}

এই এন্ডপয়েন্টের স্বাভাবিক সাফল্যের কোড হলো এই স্ট্রিং: success; সংখ্যাসূচক 200 নয়। সাধারণ আপস্ট্রিম/স্থানীয় ব্যর্থতার ক্ষেত্রে এই স্ট্রিং ব্যবহার করা হতে পারে: error। সংখ্যাসূচক 400 অবৈধ ফিল্ড বা প্রমাণপত্রের ব্যর্থতা বোঝায়, 404 বোঝায় প্রোফাইল না থাকা বা আপলোড করা ফাইলের অবৈধ রেফারেন্স, এবং 500 বোঝায় খালি বডি বা দেশ নির্ধারণ করতে না পারা। বার্তা ও যাচাইকরণের যেকোনো এন্ট্রি পড়ুন; শুধু HTTP 200-কে সাফল্য হিসেবে ধরবেন না।

হালনাগাদের বর্তমান সীমাবদ্ধতা ও পুনরুদ্ধার

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

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