REST API ডকুমেন্টেশন
ফোন‑নম্বর REST API গুলি
উপলব্ধ দেশ ও নম্বর খুঁজুন, সম্পূর্ণ অফার যাচাই করুন এবং আপনার মালিকানাধীন নম্বরগুলো পরিচালনা করুন।
API এবং ক্রেডেনশিয়াল একসঙ্গে বেছে নিন
অনুমোদিত ডেভেলপার ও অটোমেশন, ব্যবসা এবং কমিউনিকেশন প্রোভাইডার অ্যাকাউন্টগুলো সক্রিয় সার্ভিসের সঙ্গে ইন্টিগ্রেট করতে পারে। একজন স্বতন্ত্র ডেভেলপারকে কোম্পানি সাজার প্রয়োজন নেই। অ্যাপ্লিকেশন SMS/MMS-এর জন্য প্রযোজ্য প্রেরণ অনুমোদন ও নিবন্ধন আবশ্যক। ব্যক্তি ও পরিবার সার্ভিসে গ্রাহকদের বার্তা পাঠানো শুরু করার জন্য কোনো API নেই।
| API পরিবার | বেস URL | অথেনটিকেশন ও ফলাফল |
|---|---|---|
| Communications v3 | https://api.multitel.net/v3 | অনুমোদিত Basic ক্রেডেনশিয়াল; প্রভিশন করা উপযুক্ত টোকেন কেবল সেসব অপারেশনে যেগুলো তা সমর্থন করে। JSON status এবং response। |
| জরুরি কলিংয়ের জন্য নিবন্ধন | https://api.multi.tel/emergency | অনুমোদিত Basic ক্রেডেনশিয়াল বা বিশেষভাবে প্রভিশন করা bearer অ্যাক্সেস। JSON code, message এবং data। |
| পোর্টাল REST ইন্টিগ্রেশন | আপনার অ্যাকাউন্টের ডেভেলপার রেফারেন্সে দেখানো হোস্ট ও অপারেশন | সংশ্লিষ্ট অপারেশনের ডকুমেন্টেড ক্রেডেনশিয়াল, স্কোপ ও স্কিমা ব্যবহার করুন। ব্রাউজার সেশন অনুরোধের ইন্টারফেস আলাদা। |
উদাহরণগুলো ব্যবহারের আগে আপনার সার্ভারের সিক্রেট কনফিগারেশনের মাধ্যমে MULTITEL_API_USERNAME এবং MULTITEL_API_PASSWORD সেট করুন। এগুলো কখনো পাবলিক ব্রাউজার JavaScript, URL বা সোর্স কন্ট্রোলে রাখবেন না। নির্দিষ্ট ক্রেডেনশিয়ালগুলো API ইন্টিগ্রেশন সেটিংসে পরিচালনা করা হয়।
উপলব্ধ দেশের ক্যাটালগ পড়ুন
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/getcountries"v3 রেসপন্সে status এবং একটি response অ্যারে থাকে। দেশের এন্ট্রিতে isocode, name, countrycode, সক্ষমতার তথ্য এবং next_function অন্তর্ভুক্ত থাকে। উপলব্ধতা অ্যাকাউন্ট ও ইনভেন্টরির ওপর নির্ভরশীল; কোনো দেশের তালিকাভুক্তি এই প্রতিশ্রুতি নয় যে প্রতিটি প্রিফিক্স বা নম্বরের ধরন মজুত আছে।
{
"status": {
"code": 200,
"msg": "Results: 1"
},
"response": [
{
"countrycode": "1",
"name": "United States",
"description": "United States",
"isocode": "US",
"is_mobile": 0,
"sms_coverage": 1,
"latitude": "37.0902",
"longitude": "-95.7129",
"next_function": "v3/getareas/US"
}
]
}অনুসন্ধান থেকে অ্যাক্টিভেশন পর্যন্ত
- সংশ্লিষ্ট ভৌগোলিক অপারেশন ব্যবহার করে দেশ, প্রয়োজনে উপ-অঞ্চল, এলাকা এবং নম্বরের ধরন বেছে নিন।
- নির্বাচিত নম্বরের সেটআপ, মাসিক ও ব্যবহার মূল্য, কল চ্যানেল, অন্তর্ভুক্ত ব্যবহারের সীমা এবং নিবন্ধনের শর্তাবলি পড়ুন।
- প্রয়োজনীয় শেষ-ব্যবহারকারীর ডকুমেন্ট জমা দিন এবং সেগুলোর অবস্থা পর্যালোচনা করুন। অনুমোদন না হওয়া পর্যন্ত একটি নম্বর অপেক্ষমাণ থাকতে পারে।
- সঠিক ইনভেন্টরি/মূল্য নির্বাচনসহ একবারই অর্ডার করুন। রেসপন্স অনিশ্চিত হলে আরেকটি অর্ডার জমা দেওয়ার আগে আপনার ইনভেন্টরি পরীক্ষা করুন।
- ভয়েস রাউটিং এবং মেসেজিং ডেলিভারি আলাদাভাবে কনফিগার করুন, তারপর উদ্দিষ্ট সম্পূর্ণ রুট পরীক্ষা করুন।
ত্রুটি ও পুনঃচেষ্টা সামলানো
- অথেনটিকেশন বা অনুমতি সংক্রান্ত ব্যর্থতা
- API ক্রেডেনশিয়ালটি সক্রিয় আছে কি না, অনুমোদিত সার্ভিস কোনটি এবং সোর্স-আইপি সীমাবদ্ধতা কী, তা পরীক্ষা করুন। পোর্টাল সেশন কুকি কোনো ইন্টিগ্রেশন ক্রেডেনশিয়াল নয়।
- অপর্যাপ্ত ক্রেডিট বা অপূর্ণ অনুমোদন
- অপারেশনটি পুনরায় চালানোর আগে অ্যাকাউন্ট ব্যালেন্স, প্রেরণ অনুমোদন বা ডকুমেন্ট সংক্রান্ত শর্ত পূরণ করুন।
- কোনো ফলাফল নেই
- খালি ইনভেন্টরি বা অনুপস্থিত কলারের নামকে একটি স্বাভাবিক ফলাফল হিসেবে সামলান। ধরে নেবেন না যে বাক্যগঠনগতভাবে বৈধ কোনো নম্বরে সব সার্ভিস রয়েছে।
- নেটওয়ার্ক টাইমআউট বা সার্ভিস ব্যর্থতা
- রিড অপারেশনের জন্য ব্যাকঅফসহ সীমিত সংখ্যক পুনঃচেষ্টা করুন। ক্রয়, প্রেরণ বা নিবন্ধনের ক্ষেত্রে আগে অপারেশনের অবস্থা পরীক্ষা করুন; গৃহীত অনুরোধ পুনরায় পাঠালে একই বিলযোগ্য কাজ দুইবার হয়ে যেতে পারে।
Idempotency সমর্থন প্রতিটি API পরিবারের নিজস্ব বিষয়। Emergency API রিট্রাই কী সমর্থন করে; এর অর্থ এই নয় যে যেকোনো v3 অনুরোধ idempotent। সাপোর্টের জন্য টাইমস্ট্যাম্প, ফেরত পাওয়া ID এবং গোপনীয় তথ্য মুছে ফেলা রেসপন্স সংরক্ষণ করুন।
আপনার অ্যাকাউন্টের রেফারেন্স চালিয়ে যান
সাইন‑ইন করা রেফারেন্স আপনার অনুমতি এবং সক্রিয় সার্ভিস অনুযায়ী অপারেশন ফিল্টার করে। এর সঠিক হোস্ট, ক্রেডেনশিয়াল টাইপ, রিকোয়েস্ট ফিল্ড এবং রেসপন্স স্কিমা ব্যবহার করুন। কনসোলগুলি লাইভ অপারেশন সম্পাদন করতে পারে, যার মধ্যে ক্রয় এবং মেসেজ অন্তর্ভুক্ত।