কলকারীর নাম খুঁজুন

কলকারীর নাম খুঁজুন

একটি টেলিফোন নম্বরের জন্য উপলব্ধ কলকারীর নামের ফলাফল সংগ্রহ করুন। এই অনুসন্ধান সরাসরি চালু পরিষেবায় হয় এবং ফলাফল পরিষেবার ক্যাশ থেকে এলেও আপনার অ্যাকাউন্টে চার্জ হতে পারে। এটি আপনার মালিকানাধীন কোনো নম্বর থেকে বহির্গামী কলের সময় প্রদর্শিত নাম পরিবর্তন করে না।

ফেরত পাওয়া নাম পরিচয়, মালিকানা বা কল করার অনুমতির যাচাইকৃত প্রমাণ নয়। নাম অনুপস্থিত, পুরোনো বা সংক্ষিপ্ত হতে পারে; নামের জায়গায় ভৌগোলিক এলাকার পরিচিতি কিংবা বিকল্প হিসেবে টেলিফোন নম্বরও থাকতে পারে।

অনুরোধ

অনুমোদিত উৎস আইপি ঠিকানা থেকে আপনার সক্রিয় API অ্যাকাউন্ট ব্যবহার করুন। প্রমাণীকরণের তথ্য সার্ভারের গোপন তথ্যভান্ডারে রাখুন। উদাহরণে এনভায়রনমেন্ট ভেরিয়েবল এবং উত্তর আমেরিকার একটি কাল্পনিক নম্বর ব্যবহার করা হয়েছে; ইউআরএল বা সর্বসাধারণের কাছে উন্মুক্ত ব্রাউজার কোডে প্রমাণীকরণের তথ্য রাখবেন না।

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/cnam/12025550123

দেশের কোডসহ সম্পূর্ণ নম্বরটি অঙ্কে দিন, যেমন উত্তর আমেরিকার জন্য 1 দিয়ে শুরু হওয়া এগারো অঙ্কের নম্বর। বিরামচিহ্ন বা যোগচিহ্ন স্বাভাবিকীকরণের জন্য অনুরোধ প্রক্রিয়াকারীর ওপর নির্ভর করবেন না। অনুরোধের বডি বা অঞ্চল নির্বাচকের প্রয়োজন নেই। আপনার পরিকল্পিত ব্যবহারের জন্য কোন কোন এলাকায় পরিষেবা সমর্থিত, তা MultiTEL-এর কাছে নিশ্চিত করুন।

উত্তর

মানগুলো কেবল উদাহরণ; এখানে দেখানো খরচ কোনো মূল্যপ্রস্তাব নয়।

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE NAME",
    "cost": 0.0037,
    "balance": 9.9963
  }
}

চার্জ ও হিসাব মিলিয়ে দেখা

নামসহ ফলাফলের জন্য অ্যাকাউন্টে নির্ধারিত CNAM মূল্য অনুযায়ী চার্জ করা হয়। একই অনুসন্ধান আবার করলে বা ক্যাশ থেকে ফলাফল এলেও নতুন করে চার্জ হতে পারে; একই অনুরোধের পুনরাবৃত্তি শনাক্ত করার কোনো আইডেমপোটেন্সি কী দেওয়া হয় না। স্বয়ংক্রিয় অনুসন্ধান চালু করার আগে অ্যাকাউন্টের বর্তমান মূল্যহার দেখে নিন।

ক্যাশে নাম ফাঁকা থাকলে উত্তরের একটি পরিচিত সীমাবদ্ধতা রয়েছে: ওই কার্যশাখায় অ্যাকাউন্ট থেকে অর্থ না কাটলেও অনুরোধ প্রক্রিয়াকারী ফাঁকা নাম, শূন্য নয় এমন খরচ এবং কমিয়ে গণনা করা ব্যালেন্সসহ API কোড 200 ফেরত দিতে পারে। শুধু ওই উত্তরকে চার্জের প্রমাণ হিসেবে ধরবেন না। হিসাব মেলানোর জন্য অ্যাকাউন্টের বিলিং রেকর্ডের পাশাপাশি নতুন করে করুন একটি ব্যালেন্স অনুসন্ধান, এবং ফলাফল অস্পষ্ট হলে সহায়তা দলের সঙ্গে যোগাযোগ করুন।

প্রতি অনুসন্ধানের জন্য নির্ধারিত মূল্য যা-ই হোক, বর্তমান প্রিপেইড যাচাই অনুযায়ী অনুসন্ধানের আগে অন্তত 0.004 ব্যালেন্স থাকতে হবে। কেনাকাটা বন্ধ থাকা অ্যাকাউন্টের অনুরোধও প্রত্যাখ্যান করা হয়। এসব যাচাইয়ের কারণে এই এন্ডপয়েন্ট মূল্যপ্রস্তাব দেওয়া বা ব্যয়ের সীমা নির্ধারণের API হয়ে যায় না।

ত্রুটি ও পুনঃচেষ্টা

HTTP স্ট্যাটাস এবং JSON-এর status.code/status.msg উভয়ই পরীক্ষা করুন। API কোড 403 দিয়ে অপর্যাপ্ত প্রিপেইড ক্রেডিট, কেনাকাটায় নিষেধাজ্ঞা, অ্যাকাউন্টের অনুমোদনসংক্রান্ত সমস্যা অথবা কলকারীর নাম না পাওয়া বোঝাতে পারে। নাম না পাওয়ার কার্যপথে কোডটি স্ট্রিং হিসেবে ফেরত আসতে পারে। প্রতিটি 403-কে ভুল প্রমাণীকরণের তথ্যের ফল ধরে না নিয়ে বার্তাটি পরীক্ষা করুন। কনফিগারেশনে বিরোধ থাকলে API কোড 500 ফেরত আসতে পারে।

চার্জযোগ্য অনুসন্ধান সম্পন্ন হওয়ার পরেও সময়সীমা পেরিয়ে যেতে পারে। আপনার অ্যাপ্লিকেশনের জন্য উপযুক্ত হলেই চেষ্টার মধ্যবর্তী বিরতি বাড়িয়ে সীমিত সংখ্যক পুনঃচেষ্টা করুন এবং আগে অনিশ্চিত চেষ্টাগুলোর হিসাব মিলিয়ে নিন। প্রত্যাখ্যাত নম্বর বা অ্যাকাউন্টের অনুমতি কিংবা ব্যালেন্সসংক্রান্ত ব্যর্থতার ক্ষেত্রে বারবার চেষ্টা করবেন না। আপনার চুক্তির শর্ত ও নির্ভুলতার প্রয়োজনীয়তা মেনে নিজস্ব অ্যাপ্লিকেশনে উত্তরের ক্যাশ রাখলে পুনরাবৃত্ত অনুরোধ কমানো যায়।

নম্বরসংক্রান্ত অন্যান্য কার্যক্রম

এই তথ্য পড়ার কার্যক্রমটি বহির্গামী কলের নাম/LIDB হালনাগাদ, ডিরেক্টরিতে অন্তর্ভুক্তি বা কলকারীর নিবন্ধন থেকে আলাদা। ওই কার্যক্রমগুলোর নিজস্ব আবশ্যিক ক্ষেত্র, অনুমোদন ও ফি রয়েছে। প্রিফিক্স সারণি যাচাই করতে ব্যবহার করুন বরাদ্দের আওতা অথবা অর্ডারযোগ্য নম্বরের তালিকা দেখতে ব্যবহার করুন নম্বর অনুসন্ধান। এগুলোর কোনোটিই প্রমাণ করে না যে কলকারীর পরিচয় তাঁর দাবি অনুযায়ী সঠিক।