কেনা একটি নম্বরের তথ্য পড়ুন

কেনা একটি নম্বরের রেকর্ড এবং তার সংরক্ষিত কনফিগারেশন পড়ুন। এই অপারেশনটি inventory এন্ডপয়েন্টের মতো অ্যারে ফেরত দেওয়ার পরিবর্তে একটি অবজেক্ট ফেরত দেয়।

অনুরোধ

HTTPS-এর মাধ্যমে সার্ভারের দিকের API পরিচয়প্রমাণ ব্যবহার করুন। উদাহরণগুলি এনভায়রনমেন্ট ভেরিয়েবল থেকে পরিচয়প্রমাণ পড়ে; এগুলিতে কোনো কার্যকর পরিচয়প্রমাণ নেই। পরীক্ষা করুন status.code-এর মান JSON বডিতে, এবং সেই সঙ্গে HTTP স্ট্যাটাসও পরীক্ষা করুন। পুরোনো ব্যবস্থার এই হ্যান্ডলারগুলি অ্যাপ্লিকেশনের ত্রুটির জন্য সব সময় HTTP ত্রুটি স্ট্যাটাস নির্ধারণ করে না।

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/numberinfo/12025550100"

পাথের আবশ্যিক অংশটি হলো সংরক্ষিত আন্তর্জাতিক টেলিফোন নম্বর, তার UUID বা কোনো PBX এক্সটেনশন নয়। এই হ্যান্ডলার কোনো কুয়েরি প্যারামিটার বা অনুরোধের বডি ব্যবহার করে না।

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

এটি প্রতিক্রিয়ার কাঠামো বোঝানোর একটি উদাহরণ, কোনো অ্যাকাউন্টের তথ্য বা বর্তমান মূল্যের প্রস্তাব নয়।

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550100",
    "uuid": "NUMBER_UUID",
    "description": "Main reception",
    "isocode": "US",
    "config": {
      "uri": "sip:reception@example.com",
      "uri2": "",
      "uri3": "",
      "forward_destination": "",
      "sms_uri": "",
      "sms_forward_destination": ""
    },
    "features": {
      "voice": "1",
      "sms": "1",
      "mms": "0"
    },
    "status": {
      "capacity": {
        "assigned_channels": "2",
        "used_channels": "0",
        "overflow": "0",
        "overage_charge": "0.01"
      },
      "origination": {
        "origination_trunk_id": "ORIGINATION_ID",
        "origination_trunk_name": "ORIGINATION_NAME",
        "origination_country_iso": "US",
        "origination_continent_iso": "NA",
        "origination_continent_name": "North America"
      },
      "service_active": "1",
      "force_codec": "",
      "force_dtmf": ""
    },
    "billing": {
      "cnam": "0",
      "overflow": "0",
      "autorenew": "1",
      "persistent": "0",
      "date_created": "2026-01-01 00:00:00"
    },
    "price": {
      "setup_price": "0.00",
      "monthly_price": "1.00",
      "per_minute": "0.01",
      "free_minutes": "0",
      "remaining_minutes": "0",
      "perminute_charges": "0"
    },
    "needs_registration": "0",
    "vrating": "",
    "country_id": "COUNTRY_REFERENCE",
    "area_id": "AREA_REFERENCE",
    "provider_id": "OPAQUE_LEGACY_REFERENCE"
  }
}

তুলনার ভিত্তি হলো inventory; সেটির তুলনায় এই এন্ডপয়েন্ট আরও ফেরত দেয়: needs_registration, vrating, country_id, area_id, provider_id এবং price.perminute_charges। এগুলি পুরোনো ব্যবস্থার সংরক্ষিত মান, পরিচয় অনুমোদনের আলাদা কোনো প্রতিক্রিয়া নয়। রেফারেন্স ID-গুলির গঠন থেকে কোনো অর্থ অনুমান করা উচিত নয়; উপযুক্ত আবিষ্কারমূলক অনুসন্ধানের প্রতিক্রিয়া ছাড়া এগুলি থেকে সেই অনুসন্ধানের URL তৈরি করবেন না বা কোন প্রদানকারীর সঙ্গে কী সম্পর্ক রয়েছে তা অনুমান করবেন না।

মিলে যায় এমন কোনো নম্বর নেই

প্রমাণীকৃত অ্যাকাউন্টের জন্য মিলে যায় এমন কোনো বাতিল না হওয়া রেকর্ড পাওয়া না গেলে JSON বডিতে থাকে status.code 404 এবং একটি বার্তা, যার মধ্যে থাকে number not found। বার্তার শেষে যুক্ত সোর্স কোডের লাইন নির্দেশক অংশের ওপর নির্ভর করবেন না। আবার চেষ্টা করার আগে সংরক্ষিত নম্বর এবং inventory পরীক্ষা করুন।

ফলাফল ব্যবহার করুন

এটি সংরক্ষিত তথ্য পড়ার কাজ। এটি কোনো নম্বর কেনে না, পরিচয়ের নথি অনুমোদন করে না, গন্তব্য পরিবর্তন করে না এবং কোনো কল, ফ্যাক্স বা বার্তা পৌঁছাবে বলে নিশ্চয়তা দেয় না। কোনো নম্বর কনফিগার করার সময় প্রতিটি সক্রিয় সেবা আলাদাভাবে পরীক্ষা করুন।