CNAM ইন্টিগ্রেশন
CNAM REST API রেফারেন্স
HTTPS এর মাধ্যমে একটি কলার নাম অনুরোধ করুন এবং ফলাফল, চার্জ এবং ত্রুটি হ্যান্ডেল করুন।
লুকআপ আচরণ নির্বাচন করুন
| স্তর | প্রতি কুয়েরির পাবলিক মূল্য | এটি কী করে |
|---|---|---|
| Starter | ০.০০২৬ US$ | নিজস্ব এবং ক্যাশে সংরক্ষিত কলার-নাম তথ্য ব্যবহার করে। |
| Standard | ০.০০৩৭ US$ | প্রতিটি কুয়েরির জন্য একটি রিয়েল‑টাইম নেটওয়ার্ক লুকআপ করে। |
| Mixed | ০.০০৪ US$ | প্রথমে একটি রিয়েল‑টাইম লুকআপ চেষ্টা করে, তারপর কোনও নাম না পাওয়া গেলে Starter ডেটায় ফিরে যায়। |
নির্বাচিত সার্ভিস লুকআপ আচরণ নির্ধারণ করে; Mixed ক্যাশ‑প্রথম লুকআপ নয়। প্রোডাকশন ব্যবহারের আগে আপনার অ্যাকাউন্টে নির্ধারিত রেট পর্যালোচনা করুন। একটি কলার নাম পরিচয় বা মালিকানার প্রমাণ নয়।
একটি প্রমাণীকৃত লুকআপ পাঠান
এন্ডপয়েন্ট: GET https://api.multitel.net/v3/cnam/NUMBER। দেশের কোডসহ আন্তর্জাতিক বিন্যাসের ফোন নম্বর শুধু অঙ্কে লিখুন, কোনো যতিচিহ্ন বা শুরুতে প্লাস চিহ্ন ছাড়া। আপনার অ্যাপ্লিকেশন সার্ভার থেকে অনুমোদিত API ক্রেডেনশিয়াল ব্যবহার করে এটি সম্পাদন করুন।
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/cnam/12025550123"সার্ভার‑সাইড সিক্রেট কনফিগারেশনের মাধ্যমে দুটি এনভায়রনমেন্ট ভেরিয়েবল সরবরাহ করুন। একটি প্রভিশনড বেয়ারার ক্রেডেনশিয়াল কেবলমাত্র সেই অ্যাক্সেস সক্রিয় থাকলে এবং তার সোর্স‑IP সীমাবদ্ধতা পূরণ হলে বিকল্প। কখনও একটি API সিক্রেট পাবলিক ব্রাউজার বান্ডেলে রাখবেন না।
JSON রেসপন্স পড়ুন
এই রেসপন্সটি উদাহরণস্বরূপ। ফেরত নাম এবং চার্জ লুকআপ এবং নির্বাচিত সার্ভিসের উপর নির্ভর করে।
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "12025550123",
"name": "EXAMPLE CALLER",
"cost": "0.004",
"balance": "24.9960"
}
}status.code- অ্যাপ্লিকেশন ফলাফল কোড; 200-এর সঙ্গে তুলনা করার আগে স্ট্রিং/সংখ্যার মানকে একই বিন্যাসে আনুন।
status.msg- সঙ্গে দেওয়া ফলাফল বা প্রত্যাখ্যান বার্তা।
response.number- অনুসন্ধানকৃত নম্বর।
response.name- উপলব্ধ কলার নাম।
response.cost- এই কুয়েরির জন্য রিপোর্টকৃত চার্জ; এটিকে দশমিক পরিমাণ হিসাবে বিবেচনা করুন।
response.balance- রিপোর্টকৃত অ্যাকাউন্ট ব্যালেন্স, উপস্থিত থাকলে।
নাম‑বিহীন ফলাফল এবং ত্রুটি
একটি সফল অনুরোধ একটি উপকারী কলার নাম গ্যারান্টি দেয় না। একটি ফাঁকা নাম, একটি নামের স্থানে ফেরত নম্বর এবং একটি প্রত্যাখ্যাত লুকআপ হ্যান্ডেল করুন। অ্যাপ্লিকেশন কোড 403 অপর্যাপ্ত ক্রেডিট, একটি নিষিদ্ধ ক্রয় বা কোনও ফলাফল নেই এমন নম্বর বর্ণনা করতে পারে; বার্তা পরীক্ষা করুন।
response.name অ্যাক্সেস করার আগে HTTP স্ট্যাটাস এবং JSON status উভয়ই পরীক্ষা করুন। ত্রুটি হলে রেসপন্স অবজেক্ট অনুপস্থিত হতে পারে। নাম না পাওয়ার কারণে স্বাভাবিক কল রাউটিং বন্ধ হওয়া উচিত নয়।
বিলিং, পুনরায় চেষ্টা এবং কলার ID আপডেট থেকে পার্থক্য
একটি নতুন লুকআপ একটি কুয়েরি চার্জ তৈরি করতে পারে। এই লুকআপ ইন্টারফেসগুলি একটি আইডেমপোটেন্সি কী ডকুমেন্ট করে না, তাই একটি নতুন পুনরায় চেষ্টা দ্বিতীয় বিলযোগ্য কুয়েরি হতে পারে। ট্রান্সপোর্ট/সার্ভিস ব্যর্থতার জন্য সীমিত ব্যাকঅফ ব্যবহার করুন, প্রথমে অ্যাকাউন্ট ত্রুটি সমাধান করুন, এবং রিপোর্টকৃত কুয়েরি চার্জ মিলিয়ে নিন। আপনার অ্যাপ্লিকেশনের জন্য উপযুক্ত সময়ের জন্য কেবল ক্যাশ করুন; কলার‑নাম ডেটা পরিবর্তন হতে পারে।
একটি CNAM লুকআপ একটি নাম পড়ে। এটি আপনার আউটবাউন্ড কলগুলিতে প্রদর্শিত নাম পরিবর্তন করে না। একটি LIDB কলার‑নাম আপডেট একটি পৃথক অপারেশন যার নিজস্ব ক্ষেত্র, অনুমোদন, মূল্য এবং প্রক্রিয়া রয়েছে।