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.multi.tel/emergency/coverage?environment=production"https://api.multitel.net/emergency-ও সমর্থিত। জরুরি সেবার কোনো বেস URL-এ /v3 থাকে না। কভারেজে আন্তর্জাতিক সেবার আওতাভুক্ত দেশ, সমর্থিত নম্বরের ধরন ও মূল্য তালিকাভুক্ত থাকে; উত্তর আমেরিকার E911 যোগ্যতা নিবন্ধনের সময় যাচাই করা হয়।
{
"code": 200,
"message": "",
"environment": "production",
"requestId": "EXAMPLE_REQUEST_ID",
"data": {}
}এটি শুধু এনভেলপ দেখায়। প্রতিটি অপারেশনের data স্কিমা প্রকাশিত Emergency API নির্দেশিকায় পড়ুন।
নিবন্ধন করুন, স্ট্যাটাস অনুসরণ করুন, তারপর কলিং কনফিগার করুন
- যুক্তরাষ্ট্র/কানাডা এবং উত্তর আমেরিকার অন্যান্য সমর্থিত E911 অঞ্চলের জন্য নম্বর, E911 ঠিকানা এবং প্রয়োজনীয় সম্মতি নিশ্চিত করুন। উত্তর আমেরিকার E911 শুধু বাস্তব ব্যবহারের প্রোডাকশন পরিবেশে চলে।
- সমর্থিত মালিকানাধীন আন্তর্জাতিক নম্বরের জন্য একটি সংরক্ষিত Document রেফারেন্স অথবা শেষ-ব্যবহারকারীর পরিচয় ও ঠিকানা দিন। আগে দেশ ও নম্বরের ধরনের শর্তাবলি পর্যালোচনা করুন।
- একটি
POST /registrationsঅনুরোধ পাঠান। একটি ঐচ্ছিকIdempotency-Keyএকটি যৌক্তিক পরিবর্তনকে শনাক্ত করে; পুনঃচেষ্টার সময় এটি এবং হুবহু একই পেলোড সংরক্ষণ করুন। GET /registrations/:numberপড়ুন। লাইফসাইকেল,pendingএবংactionRequiredপরীক্ষা করুন; প্রয়োজনীয় সংশোধনগুলো সমাধান করুন। গৃহীত বা অপেক্ষমাণ অবস্থা মানে সক্রিয় সার্ভিস নয়।- অ্যাক্টিভেশনের পর সঠিক ইমার্জেন্সি কলার ID এবং দেশ-নির্দিষ্ট ডায়ালিং রুট কনফিগার করুন। সার্ভিসের নন-ইমার্জেন্সি যাচাইকরণ পদ্ধতি ব্যবহার করুন।
আন্তর্জাতিক স্যান্ডবক্স নিবন্ধন আলাদা থাকে এবং বাস্তব ইমার্জেন্সি কলিং সক্রিয় করে না। উত্তর আমেরিকার E911-এর জন্য প্রধান অ্যাকাউন্টের ক্রেডেনশিয়াল প্রয়োজন; সীমিত আন্তর্জাতিক সাবঅ্যাকাউন্ট সমর্থন নির্দেশিকায় ব্যাখ্যা করা হয়েছে।
ত্রুটি ও পুনঃচেষ্টা সামলানো
- অথেনটিকেশন বা অনুমতি সংক্রান্ত ব্যর্থতা
- API ক্রেডেনশিয়ালটি সক্রিয় আছে কি না, অনুমোদিত সার্ভিস কোনটি এবং সোর্স-আইপি সীমাবদ্ধতা কী, তা পরীক্ষা করুন। পোর্টাল সেশন কুকি কোনো ইন্টিগ্রেশন ক্রেডেনশিয়াল নয়।
- অপর্যাপ্ত ক্রেডিট বা অপূর্ণ অনুমোদন
- অপারেশনটি পুনরায় চালানোর আগে অ্যাকাউন্ট ব্যালেন্স, প্রেরণ অনুমোদন বা ডকুমেন্ট সংক্রান্ত শর্ত পূরণ করুন।
- কোনো ফলাফল নেই
- খালি ইনভেন্টরি বা অনুপস্থিত কলারের নামকে একটি স্বাভাবিক ফলাফল হিসেবে সামলান। ধরে নেবেন না যে বাক্যগঠনগতভাবে বৈধ কোনো নম্বরে সব সার্ভিস রয়েছে।
- নেটওয়ার্ক টাইমআউট বা সার্ভিস ব্যর্থতা
- রিড অপারেশনের জন্য ব্যাকঅফসহ সীমিত সংখ্যক পুনঃচেষ্টা করুন। ক্রয়, প্রেরণ বা নিবন্ধনের ক্ষেত্রে আগে অপারেশনের অবস্থা পরীক্ষা করুন; গৃহীত অনুরোধ পুনরায় পাঠালে একই বিলযোগ্য কাজ দুইবার হয়ে যেতে পারে।
Idempotency সমর্থন প্রতিটি API পরিবারের নিজস্ব বিষয়। Emergency API রিট্রাই কী সমর্থন করে; এর অর্থ এই নয় যে যেকোনো v3 অনুরোধ idempotent। সাপোর্টের জন্য টাইমস্ট্যাম্প, ফেরত পাওয়া ID এবং গোপনীয় তথ্য মুছে ফেলা রেসপন্স সংরক্ষণ করুন।
আপনার অ্যাকাউন্টের রেফারেন্স চালিয়ে যান
সাইন‑ইন করা রেফারেন্স আপনার অনুমতি এবং সক্রিয় সার্ভিস অনুযায়ী অপারেশন ফিল্টার করে। এর সঠিক হোস্ট, ক্রেডেনশিয়াল টাইপ, রিকোয়েস্ট ফিল্ড এবং রেসপন্স স্কিমা ব্যবহার করুন। কনসোলগুলি লাইভ অপারেশন সম্পাদন করতে পারে, যার মধ্যে ক্রয় এবং মেসেজ অন্তর্ভুক্ত।