প্রোফাইলটি একবারই তৈরি করুন
এই অনুরোধটি ক্যারিয়ার পরিচয় ও ঠিকানা রেকর্ডের সাথে একটি স্থানীয় নিবন্ধন প্রোফাইল তৈরি করে। বর্তমান নিবন্ধন দেশসমূহ, নম্বরের ধরন এবং প্রয়োজনীয়তা দিয়ে শুরু করুন। প্রয়োজনীয়তা নির্ভর করে আপনি যে দেশে এবং যে ধরনের নম্বর নিবন্ধন করার পরিকল্পনা করছেন তার উপর।
একটি সফল তৈরি-প্রতিক্রিয়া নিয়ন্ত্রক অনুমোদন বা নম্বর সক্রিয়করণ নয়। ডকুমেন্ট UUID, পরিচয় ID এবং ঠিকানা ID আলাদাভাবে সংরক্ষণ করুন: এগুলি ভিন্ন ভিন্ন উদ্দেশ্যে ব্যবহৃত হয়। এই অনুরোধটি অ্যাকাউন্টের ডেটা পরিবর্তন করে এবং এটি শুধুমাত্র-যাচাইকরণ অপারেশন নয়।
তৈরি করার অনুরোধ
আপনার সক্রিয় MultiTEL API অ্যাকাউন্ট এবং এর অনুমোদিত IP ঠিকানা দিয়ে প্রমাণীকরণ করুন। উদাহরণগুলিতে পরিবেশ ভেরিয়েবলে সংরক্ষিত HTTP Basic শংসাপত্র ব্যবহার করা হয়েছে। HTTP প্রতিক্রিয়া এবং JSON status.code উভয়ই পরীক্ষা করুন; শুধুমাত্র একটি HTTP 200 প্রতিক্রিয়া সাফল্য প্রতিষ্ঠা করে না। সমস্ত উদাহরণ মান কাল্পনিক।
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--header 'Content-Type: application/json' \
--data @registration-profile.json \
https://api.multitel.net/v3/create_document{
"identity_type": "Personal",
"first_name": "Example",
"last_name": "Person",
"phone_number": "12025550123",
"email": "end-user@example.com",
"city": "Example City",
"postal_code": "00000",
"country": "US",
"address": "1 Example Street",
"nationality": "US",
"signature": "BASE64_PNG_OF_THE_AUTHORIZED_END_USER_SIGNATURE"
}এই JSON একটি উদাহরণমূলক Personal প্রোফাইল, জমা দেওয়ার জন্য প্রস্তুত কোনো প্রকৃত পরিচয় নয়। নির্বাচিত নিবন্ধন নিয়ম অনুযায়ী প্রয়োজনীয় শেষ-ব্যবহারকারীর তথ্য দিয়ে এর বিবরণ ও স্বাক্ষর প্রতিস্থাপন করুন। ফর্ম-এনকোডেড ইনপুটও সমর্থিত।
| ফিল্ড | আবশ্যকতা ও ফরম্যাট |
|---|---|
identity_type | আবশ্যক। সঠিক মান Personal অথবা Business ব্যবহার করুন; শর্তসাপেক্ষ যাচাইকরণ বড়/ছোট হাতের অক্ষরের উপর নির্ভর করে। |
first_name, last_name | আবশ্যক, প্রতিটি সর্বোচ্চ 64 অক্ষর। ব্যবসার ক্ষেত্রে, নির্বাচিত দেশের জন্য প্রয়োজনীয় প্রতিনিধির বিবরণ প্রদান করুন। |
phone_number | আবশ্যক সাংখ্যিক টেলিফোন মান, কমপক্ষে আট অক্ষর। দেশের কোডসহ শুধুমাত্র অঙ্কযুক্ত একটি আন্তর্জাতিক নম্বর এই যাচাইকরণের জন্য উপযুক্ত; এটি একটি যোগাযোগ নম্বর, নম্বর ক্রয় নয়। |
city, postal_code, address | আবশ্যক, প্রতিটি সর্বোচ্চ 64 অক্ষর। |
country | নিবন্ধন ক্যাটালগ থেকে আবশ্যক ঠিকানা-দেশের ISO কোড। পরিষেবাটি এটিকে ক্যারিয়ার দেশের রেকর্ডে রূপান্তরিত করে। |
signature | আবশ্যক স্বাক্ষর ডেটা। বর্তমান পোর্টাল data:image/png;base64, প্রিফিক্স ছাড়া Base64 PNG ছবির বাইট সরবরাহ করে। আপনার অনুমোদিত কর্মপ্রবাহের মাধ্যমে শেষ-ব্যবহারকারীর স্বাক্ষর সংগ্রহ করুন; একটি অশূন্য প্লেসহোল্ডার অর্থপূর্ণ স্বাক্ষর নয়। |
nationality | Personal-এর জন্য আবশ্যক, একটি দেশের ISO কোড হিসেবে। এর পরিবর্তে দেশের UUID ব্যবহার করবেন না। |
company_name, incorporation_country | Business-এর জন্য আবশ্যক। কোম্পানির নাম সর্বোচ্চ 64 অক্ষর; incorporation_country একটি দেশের ISO কোড। |
email | ঐচ্ছিক শেষ-ব্যবহারকারীর যোগাযোগ ইমেল, সর্বোচ্চ 254 অক্ষর। বাদ দেওয়া বা খালি ইমেল বেস অ্যাকাউন্টের ইমেল উত্তরাধিকারসূত্রে পায় না। |
company_reg_number, vat_id, id_number, personal_tax_id, birth_date, description | এই হ্যান্ডলারে ঐচ্ছিক, তবে নির্বাচিত দেশ/ক্যারিয়ার এগুলির কিছু আবশ্যক করতে পারে। সেই নিবন্ধনের জন্য প্রয়োজনীয় ফরম্যাট সরবরাহ করুন। সরাসরি API কল পোর্টাল দ্বারা সম্পাদিত প্রতিটি স্বাভাবিকীকরণ স্বয়ংক্রিয়ভাবে প্রয়োগ করে না। |
এই সরাসরি v3 হ্যান্ডলারের জন্য ঠিকানার ফিল্ড আবশ্যক এবং এটি একটি ঠিকানা তৈরি করে। ধরে নেবেন না যে পোর্টালের ঠিকানা-স্থগিত রাখার বিকল্পটি এর মাধ্যমে উপলব্ধ।
তিনটি শনাক্তকারীই সংরক্ষণ করুন
নিচে নির্বাচিত প্রতিক্রিয়া ফিল্ডগুলি দেখানো হয়েছে; প্রকৃত প্রতিক্রিয়ায় জমা দেওয়া প্রোফাইল তথ্য ও স্বাক্ষর ডেটাও থাকে। সম্পূর্ণ প্রতিক্রিয়াটিকে গোপনীয় হিসেবে পরিচালনা করুন।
{
"status": {
"code": 200,
"msg": "Success Create Registration Detail."
},
"response": {
"uuid": "11111111111111111111111111111111",
"identity_id": "22222222222222222222222222222222",
"address_id": "33333333333333333333333333333333",
"country_iso": "US",
"email": "end-user@example.com"
}
}response.uuidস্থানীয় প্রোফাইল শনাক্ত করে। এটি get_document-এর সাথে ব্যবহার করুন। documents এবং get_document প্রতিক্রিয়ায়, একই প্রোফাইল শনাক্তকারীর নাম হলোid।response.identity_idপরবর্তী পরিচয় প্রমাণ এবং সহায়ক নথি-এর জন্য পরিচয়টি শনাক্ত করে।response.address_idতৈরি করা ঠিকানা শনাক্ত করে। এটি আলাদাভাবে রাখুন; স্থানীয় প্রোফাইল UUID কোনো ঠিকানা ID নয়। নতুন তৈরি প্রোফাইলের জন্য পরবর্তী ঠিকানা-প্রমাণ সংযুক্তির সামঞ্জস্য এখনও পর্যালোচনাধীন।
দুটি প্রোফাইল রিডব্যাক এন্ডপয়েন্ট identity_id বা address_id ফেরত দেয় না, তাই মূল সফল তৈরি-প্রতিক্রিয়াটি সংরক্ষণ করুন। এটি হারিয়ে গেলে, প্রতিস্থাপন তৈরি করার আগে পোর্টাল ডকুমেন্ট ভিউ ব্যবহার করুন অথবা সহায়তার সাথে যোগাযোগ করুন।
উন্নত: তৈরির সময় পূর্বে আপলোড করা প্রমাণ সংযুক্ত করুন
আপনি identity_encryptfiles এবং address_encryptfiles-কে এমন ID-র অ্যারে হিসেবে সরবরাহ করতে পারেন যা create_encrypt_files ফেরত দেয়। মিলে যাওয়া সত্তা বিভাগের জন্য একটি প্রমাণের ধরন ব্যবহার করে আপলোড করুন, তারপর ফাইল-রেফারেন্সের মেয়াদ শেষ হওয়ার আনুমানিক 20 মিনিটের আগে জমা দিন। তৈরি হ্যান্ডলার সরবরাহ করা প্রতিটি রেফারেন্সের অ্যাকাউন্ট, বিভাগ ও মেয়াদ পরীক্ষা করে।
এই ফিল্ডগুলির নাম পরবর্তী সংযুক্তি এন্ডপয়েন্টের encrypted_file_ids থেকে আলাদা। তৈরির সময়, প্রতিটি ফাইল একটি পৃথক প্রমাণ অনুরোধ হিসেবে পাঠানো হয়, এমনকি যখন একাধিক ফাইল একই প্রমাণের ধরন ভাগ করে নেয় তখনও। যে পরিচয় প্রমাণে একসাথে একাধিক ফাইল থাকা আবশ্যক, তার জন্য পরবর্তীতে একটি অ্যারেসহ create_proof অনুরোধ ব্যবহার করুন। শুধুমাত্র সফল প্রোফাইল তৈরি পৃথক প্রমাণ অনুমোদনের ফলাফল প্রদান করে না।
যদি নতুন তৈরি ঠিকানার জন্য পরবর্তী কোনো ঠিকানা প্রমাণ প্রত্যাখ্যাত হয়, তবে বিকল্প হিসেবে প্রোফাইল UUID ব্যবহার করবেন না বা বারবার পরিচয় পুনরায় তৈরি করবেন না। থামুন এবং পোর্টালে বা সহায়তার সাথে প্রোফাইলটি পরীক্ষা করুন। ঠিকানা-প্রমাণের রিডব্যাক/লুকআপ পথ এখনও একটি পর্যালোচনা সীমাবদ্ধতা হিসেবে রয়ে গেছে।
ব্যর্থতা ও আংশিক তৈরি
API কোড 400 ফিল্ড যাচাইকরণ, ক্যারিয়ার তৈরির ব্যর্থতা এবং স্থানীয় সংরক্ষণের ব্যর্থতা অন্তর্ভুক্ত করে। যাচাইকরণ ত্রুটি response-এ ফিল্ড-কীযুক্ত এন্ট্রি হিসেবে দেখা দিতে পারে। অনুপলব্ধ/অবৈধ নিবন্ধন দেশের জন্য কোড 500 ব্যবহৃত হয়, এবং অনুপস্থিত বা মেয়াদোত্তীর্ণ পূর্বে আপলোড করা রেফারেন্সের জন্য কোড 404। কোডের পাশাপাশি status.msg-ও পড়ুন।
স্থানীয় প্রোফাইল এবং আপস্ট্রিম ক্যারিয়ার অপারেশন একটি একক পারমাণবিক লেনদেন নয়। একটি ব্যর্থ অনুরোধ আপস্ট্রিমে অবস্থা রেখে যেতে পারে, এমনকি যখন কোনো স্থানীয় প্রোফাইল তালিকাভুক্ত না থাকে তখনও। কোনো ক্লায়েন্ট আইডেমপোটেন্সি কী উন্মুক্ত করা হয় না। টাইমআউট বা অনিশ্চিত ব্যর্থতার পরে, তৈরি পুনরাবৃত্তি করার আগে বিদ্যমান প্রোফাইল পরীক্ষা করুন এবং সহায়তার সাথে যোগাযোগ করুন; একটি খালি documents তালিকা এই প্রমাণ নয় যে আপস্ট্রিমে কিছুই তৈরি হয়নি।