রাউটিংয়ের তথ্য খুঁজুন
উত্তর আমেরিকার কোনো টেলিফোন নম্বরের রাউটিংয়ের তথ্যের জন্য অনুরোধ করুন। উপলব্ধ রাউটিং বা ক্যারিয়ারের তথ্য বুঝতে এটি ব্যবহার করুন; গ্রাহকের পরিচয়, মালিকানা, নম্বরটিতে যোগাযোগ করা সম্ভব কি না বা নম্বরটি কেনার জন্য উপলব্ধ কি না, তার প্রমাণ হিসেবে ব্যবহার করবেন না। অনুসন্ধানের জন্য আপনার অ্যাকাউন্টে খরচ ধার্য হতে পারে।
অনুরোধ
আপনার সক্রিয় API অ্যাকাউন্ট এবং সেটির জন্য অনুমোদিত উৎস IP ঠিকানা ব্যবহার করুন। দেশের কোড 1 সহ সম্পূর্ণ নম্বরটি অঙ্কে দিন। উদাহরণে এনভায়রনমেন্ট ভেরিয়েবল ও একটি কাল্পনিক নম্বর ব্যবহার করা হয়েছে। অনুরোধ প্রক্রিয়াকারী বিরামচিহ্নকে মানসম্মত রূপে রূপান্তর করে না; জমা দেওয়ার আগে ইনপুট যাচাই করুন।
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/lrn/12025550123প্রতিক্রিয়া
কেবল উদাহরণ হিসেবে নির্বাচিত কয়েকটি ক্ষেত্র দেখানো হয়েছে; কোন ক্ষেত্র পাওয়া যাবে তা উৎস ও নম্বরের ধরনের ওপর নির্ভর করে।
{
"status": {
"code": 200,
"msg": "Success"
},
"response": {
"lrn": "12025550123",
"ocn": "0000",
"local": 1,
"ported": 0,
"cost": "$0.00025"
}
}সাধারণ অনুসন্ধানে ফেরত পাওয়া ক্ষেত্রগুলোর নাম ছোট হাতের অক্ষরে রূপান্তর করা হয়। উৎসের ওপর নির্ভর করে ক্যারিয়ার, রেট সেন্টার, অবস্থান ও অধিক্ষেত্রের তথ্যের ক্ষেত্র থাকতে পারে। প্রতিক্রিয়াটি গ্রাহকের কোনো নির্দিষ্ট বিন্যাসের সম্পূর্ণ রেকর্ড নয়। local ফ্ল্যাগের মান সংখ্যাগত 1 বা স্ট্রিং 0 হতে পারে। অনুরোধ প্রক্রিয়াকারী ফেরত পাওয়া রাউটিং নম্বরের সঙ্গে সরবরাহ করা টেলিফোন নম্বর তুলনা করে ported নির্ণয় করে; এটিকে নম্বর পোর্ট করার যাচাইকৃত সম্পূর্ণ ইতিহাস হিসেবে ব্যাখ্যা করবেন না।
খরচ ও পুনরায় চেষ্টা
পর্যালোচিত অনুরোধ প্রক্রিয়াকারী তার প্রক্রিয়া সমাপ্তির পথে পৌঁছে অনুসন্ধানটি নথিভুক্ত করার সময় অ্যাকাউন্ট থেকে $0.00025 কেটে নেয়। ফেরত পাওয়া খরচ সাধারণত শুধু সংখ্যাগত পরিমাণ হিসেবে নয়, ডলার চিহ্নসহ স্ট্রিং হিসেবে থাকে। একই অনুরোধ পুনরাবৃত্তি হলেও একবারই কার্যকর করা নিশ্চিত করার কোনো কী উন্মুক্ত করা হয়নি। অনুরোধ পুনরাবৃত্তি করলে আবার খরচ ধার্য হতে পারে।
প্রিপেইড অ্যাকাউন্টের ক্ষেত্রে কোড অন্তত 0.00025 ব্যালেন্স আছে কি না পরীক্ষা করে। অপর্যাপ্ত ব্যালেন্সের বার্তায় বর্তমানে $5 উল্লেখ করা হয়, যা ওই ন্যূনতম সীমার সঙ্গে মেলে না। এই ব্যর্থতাকে ব্যালেন্সের কারণে অনুরোধ প্রত্যাখ্যান হিসেবে বুঝুন এবং আবার চেষ্টা করার আগে অ্যাকাউন্টে অর্থ আছে কি না নিশ্চিত করুন।
ব্যর্থতা ও অসম্পূর্ণ সাফল্য
HTTP অবস্থা এবং JSON-এর status.code/status.msg উভয়ই পড়ুন। সাধারণ অনুসন্ধানের ফল খালি হলে API কোড 404 ফেরত আসে। API কোড 403 অপর্যাপ্ত প্রিপেইড ব্যালেন্স নির্দেশ করতে পারে।
টোল-ফ্রি নম্বরের ক্ষেত্রে বর্তমানে একটি ত্রুটির পথে কার্যকর রাউটিং ক্ষেত্র ছাড়াই অনুসন্ধানের অর্থ কেটে নেওয়া এবং API কোড 200 জানানো হতে পারে; এতে খরচের তথ্য অসম্পূর্ণ থাকতে পারে। তাই শুধু 200 কোড পেলেই অনুসন্ধানের ফল ব্যবহারযোগ্য বলে নিশ্চিত হওয়া যায় না। আপনার অ্যাপ্লিকেশনের জন্য প্রয়োজনীয় ক্ষেত্রগুলো যাচাই করুন, অনিশ্চিত খরচ অ্যাকাউন্টের বিলিং রেকর্ডের সঙ্গে মিলিয়ে দেখুন এবং অসম্পূর্ণ ফলের জন্য সহায়তা দলের সঙ্গে যোগাযোগ করুন।
পর্যালোচিত বাস্তবায়নে ইনপুটের দৈর্ঘ্য অনুযায়ী টোল-ফ্রি নম্বর প্রক্রিয়াকরণের ধরন আলাদা হয়। সম্পূর্ণ আন্তর্জাতিক নম্বর অঙ্কে দেওয়াকে অগ্রাধিকার দিন এবং প্রয়োজনীয় টোল-ফ্রি নম্বরগুলোর জন্য সেবা পাওয়া যায় কি না সহায়তা দলের সঙ্গে নিশ্চিত করুন। ভুল বিন্যাসের বা অসম্পূর্ণ ফল পেলে স্বয়ংক্রিয়ভাবে আবার চেষ্টা করবেন না এবং কোনো নম্বরে কল করা নিরাপদ কি না বা কল করার অনুমতি আছে কি না নির্ধারণ করতে রাউটিং অনুসন্ধানের ওপর নির্ভর করবেন না।