অ্যাকাউন্ট ও প্রজেক্টে প্রবেশাধিকার
অনুমোদিত IP ঠিকানা থেকে সক্রিয় API অ্যাকাউন্ট HTTPS-এর মাধ্যমে ব্যবহার করুন। প্রজেক্টটি সেই অ্যাকাউন্টের হতে হবে এবং মুছে ফেলা হয়ে থাকলে চলবে না। পোর্টিং অর্ডারের প্রক্রিয়া থেকে পাওয়া প্রজেক্টের স্বতন্ত্র ID ব্যবহার করুন, ডেটাবেসের সাংখ্যিক ID বা ফোন নম্বর নয়। অনুরোধ তৈরি করার সময় প্রজেক্ট ID-কে URL-এনকোড করুন।
অনুরোধ
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"উত্তর
কাল্পনিক উত্তরের উদাহরণ।
{
"status": {
"code": 200,
"msg": "Project Numbers",
"results": 1
},
"response": [
{
"id": 21,
"number": "12025550123",
"status": 0,
"status_str": "Pending",
"isocode": "US",
"updated": "2026-10-23 12:00:00",
"foc": "",
"comment": "Example customer-visible note",
"date_created": "2026-10-23 12:00:00",
"date_completed": ""
}
]
}response একটি তালিকা। কোনো নম্বর নেই এমন বিদ্যমান প্রজেক্ট API কোড 200 এবং status.results-এর মান 0 সহ একটি খালি তালিকা ফেরত দেয়। অন্যদিকে, অনুপস্থিত প্রজেক্ট API কোড 404 ফেরত দেয়।
নম্বরের ফিল্ড
| ফিল্ড | অর্থ |
|---|---|
| id, number, isocode | সারির সাংখ্যিক ID, সংরক্ষিত ফোন নম্বরের টেক্সট এবং দেশের কোড। সারির ID প্রজেক্টের ID নয়। |
| status, status_str | সাংখ্যিক অবস্থা ও তার পরিচিত লেবেল। |
| foc | চূড়ান্ত অর্ডার প্রতিশ্রুতির সময়সূচির সংরক্ষিত মান। এটি খালি হতে পারে; হ্যান্ডলার একে কোনো নথিভুক্ত সময় অঞ্চল বা টাইমস্ট্যাম্প বিন্যাসে রূপান্তর করে না। |
| updated, date_created, date_completed | আপডেট, তৈরি ও সম্পূর্ণ হওয়ার সংরক্ষিত মান। খালি মান স্পষ্টভাবে সামলান; ISO8601 ধরে নেবেন না বা কাল্পনিক উদাহরণ থেকে সময় অঞ্চল অনুমান করবেন না। |
| comment | গ্রাহককে দেখানোর জন্য সংরক্ষিত মন্তব্য। এটিকে টেক্সট হিসেবে দেখান, চালানো যায় এমন HTML হিসেবে নয়। |
ফেরত দেওয়া এই ডেটার গঠনে কেবল কর্মীদের জন্য নির্দিষ্ট internal_comment ফিল্ডটি বাদ দেওয়া হয়। এর অর্থ এই নয় যে পুরোনো পদ্ধতিতে আলাদা একটি নম্বর খোঁজার ফলও একই ডেটার গঠন ব্যবহার করে।
ক্রম ও পর্যবেক্ষণ
কোয়েরি তৈরির সময়ের ঊর্ধ্বক্রমে সাজায়। একই তৈরির সময় থাকা সারিগুলোর অতিরিক্ত কোনো ক্রম নিশ্চিত নয়। পৃষ্ঠাভাগ, ক্রমবর্ধমান কার্সর বা তারিখের ফিল্টার নেই। প্রজেক্টের তথ্য মেলাতে সম্পূর্ণ তালিকা পড়ুন এবং বর্তমান সারির সংখ্যাকে স্থায়ী ক্যাটালগ হিসেবে ধরবেন না।
পোর্টিংয়ের অবস্থা বুঝুন
| মান | লেবেল |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
সাংখ্যিক অবস্থা রাখুন এবং অজানা মানও সামলান। অপরিচিত লেবেলের ক্ষেত্রে নতুন লেবেল নিশ্চিত করা হয় না, বরং সংরক্ষিত মান ব্যবহৃত হয়। সংরক্ষিত সম্পন্ন অবস্থা বা নির্ধারিত তারিখ নিজে থেকে ইনবাউন্ড রাউটিং বা নম্বরটির সব পরিষেবা পরীক্ষা করে না।
ত্রুটি ও সীমা
HTTP উত্তর এবং status.code/status.msg দুটোই পরীক্ষা করুন। অনুপস্থিত, মুছে ফেলা বা অ্যাকাউন্টের মালিকানাধীন নয় এমন প্রজেক্ট API কোড 404 ও প্রজেক্ট না পাওয়ার বার্তা ফেরত দেয়। প্রমাণীকরণ ও উৎস IP-এর বিধিনিষেধও প্রযোজ্য। উদাহরণগুলো কোনো লাইভ অনুরোধ পাঠায় না এবং সফল উত্তর প্রমাণ করে না যে অপারেটর স্থানান্তর গ্রহণ বা সম্পন্ন করেছে।
প্রভাব
পর্যালোচিত হ্যান্ডলার শুধু প্রজেক্ট ও তার নম্বরগুলোর সংরক্ষিত সারি পড়ে। উত্তরটি একটি নির্দিষ্ট সময়ের অবস্থা, অপারেটরের নিশ্চিতকরণ বা লাইভ পরিষেবা পরীক্ষা নয়। এটি পোর্টিং শুরু করে না, রাউটিং বদলায় না বা অ্যাকাউন্ট থেকে টাকা কাটে না।