একটি এক্সচেঞ্জের জন্য মোবাইল ইনভেন্টরি পরীক্ষা করুন

একটি সমর্থিত প্রিফিক্স বেছে নিন

ডিসকভারি থেকে একটি বর্তমান পৃথক মোবাইল প্রিফিক্স ব্যবহার করুন। এই এন্ডপয়েন্টটি NANPA এক্সচেঞ্জের জন্য প্রযোজ্য: একটি NPA এরিয়া কোড নির্দেশ করে এবং একটি NXX এক্সচেঞ্জ নির্দেশ করে। শুধু এরিয়া-কোডযুক্ত প্রিফিক্স অতিরিক্ত বিস্তৃত। গোষ্ঠীভূত ডিসপ্লে ID পাঠাবেন না বা অন্য কোনো দেশের প্রিফিক্সে যথেষ্ট সংখ্যক ডিজিট থাকার কারণে সেই দেশ সমর্থিত বলে অনুমান করবেন না।

গণনাটিকে একটি ইঙ্গিত হিসেবে ব্যবহার করুন

পড়ুন response.count, যার সাথে response.npa এবং response.nxx এক্সচেঞ্জটি চিহ্নিত করে। এটি কভারেজ পরিষেবার একটি স্ন্যাপশট, আপনার অ্যাকাউন্টের জন্য ধারণকৃত স্টক নয়। অর্ডার করার আগে প্রকৃত নম্বর, প্রযোজ্য মূল্যপ্রস্তাব এবং যেকোনো নিবন্ধন প্রয়োজনীয়তা নিশ্চিত করুন। সফল একটি গণনা কখনও কেনাকাটার অনুমোদন দেয় না।

শূন্য স্টক এবং ব্যর্থ লুকআপের মধ্যে পার্থক্য করুন

শূন্যের একটি সফল গণনা API ত্রুটি থেকে ভিন্ন। পরিদর্শন করুন status.code এবং status.msg এবং HTTP স্ট্যাটাসও। একটি টাইমআউট বা ব্যর্থ লুকআপকে অজানা প্রাপ্যতা হিসেবে গণ্য করুন এবং পরে ব্যাকঅফ সহ পুনরায় চেষ্টা করুন।

অনুরোধ

HTTPS-এর মাধ্যমে আপনার সক্ষম API অ্যাকাউন্টের শংসাপত্র ব্যবহার করুন। Basic প্রমাণীকরণ এবং সক্ষম API-অ্যাকাউন্ট বিয়ারার টোকেন সমর্থিত; অ্যাকাউন্ট সীমাবদ্ধতা প্রযোজ্য।

URL পাথে প্রিফিক্স শনাক্তকারী সহ GET। কোনো নথিভুক্ত কোয়েরি বা বডি প্যারামিটার নেই।

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"

প্রতিক্রিয়া

HTTP স্ট্যাটাসের পাশাপাশি JSON বডিতে status.code পরীক্ষা করুন। একটি সফল response-এ status.code 200 এবং status.msg Results থাকে। response একটি অবজেক্ট, তালিকা নয়: count একটি পূর্ণসংখ্যা ইনভেন্টরি স্ন্যাপশট; npa এবং nxx তিন-অক্ষরের স্ট্রিং। এই অ্যাসোসিয়েটিভ অবজেক্টের জন্য status.results উপস্থিত নেই। 0 গণনার অর্থ হলো কভারেজ লুকআপে কোনো মিলে যাওয়া এক্সচেঞ্জ ছিল না বা শূন্য স্টক ফেরত এসেছে; এটি প্রমাণ করে না যে সব সরবরাহকারীর বা অন্য ডিসকভারি রুটের কোনো নম্বর নেই।

চিত্রণমূলক প্রতিক্রিয়া গঠন; এটি লাইভ অ্যাকাউন্ট ডেটা বা বর্তমান মূল্যপ্রস্তাব নয়।

{
  "status": {
    "code": 200,
    "msg": "Results"
  },
  "response": {
    "count": 42,
    "npa": "212",
    "nxx": "555"
  }
}

ত্রুটি

• 404: প্রোভাইডার নিষ্ক্রিয়: পরিষেবাতে মোবাইল ইনভেন্টরি কভারেজ অনুপলব্ধ।
• 404: অবৈধ প্রিফিক্স ID: ডিসকভারি থেকে একটি বর্তমান পৃথক প্রিফিক্স ID সংগ্রহ করুন।
• 404: অবৈধ প্রিফিক্স: সংরক্ষিত প্রিফিক্সে NPA/NXX লুকআপের জন্য যথেষ্ট সংখ্যক ডিজিট নেই।
• 500: ইনভেন্টরি কভারেজ ব্যর্থ: আপস্ট্রিম লুকআপ সফল কভারেজ ফলাফল ফেরত দেয়নি। পরে ব্যাকঅফ সহ পুনরায় চেষ্টা করুন; ব্যর্থতা মানে শূন্য স্টক গণনা নয়।

প্রাপ্যতা এবং পার্শ্ব প্রভাব

• এই অপারেশনটি ইনভেন্টরি পরীক্ষা করে এবং কোনো অর্ডার দেয় না, নম্বর সংরক্ষণ করে না বা কেনার পরিমাণ ডেবিট করে না।
• স্টক অবিলম্বে পরিবর্তিত হতে পারে। কভারেজ গণনাটি অ্যাকাউন্ট-নির্দিষ্ট ক্রয়যোগ্যতা বা পরবর্তী নম্বর-অনুসন্ধান প্রতিক্রিয়ার একই দৈর্ঘ্যের প্রতিশ্রুতি দেওয়ার জন্য সমন্বয় করা হয়নি।
• একটি লুকআপ কভারেজ পরিষেবার সাথে যোগাযোগ করে এবং সময় নিতে পারে। প্রতিটি প্রিফিক্স বারবার পোল করবেন না, বা টাইমআউট/ত্রুটিকে সফল শূন্য স্টক হিসেবে গণ্য করবেন না।