ერთი შეძენილი ნომრის მონაცემების წაკითხვა

წაიკითხეთ ერთი შეძენილი ნომრის ჩანაწერი და მისი შენახული კონფიგურაცია. ეს ოპერაცია აბრუნებს ობიექტს და არა inventory ენდპოინტის მიერ დაბრუნებულ მასივს.

მოთხოვნა

გამოიყენეთ სერვერის მხარის API-ის ავტორიზაციის მონაცემები HTTPS-ის მეშვეობით. მაგალითები ავტორიზაციის მონაცემებს გარემოს ცვლადებიდან კითხულობს; ისინი მოქმედ ავტორიზაციის მონაცემებს არ შეიცავს. შეამოწმეთ 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. ეს ძველი სისტემის შენახული მნიშვნელობებია და არა პირადობის დამტკიცების ცალკე პასუხი. საცნობარო იდენტიფიკატორების შიდა სტრუქტურას მნიშვნელობა არ უნდა მიანიჭოთ; შესაბამისი მოძიების პასუხის გარეშე მათგან ნუ ააგებთ მოძიების URL-ებს და ნუ დაასკვნით პროვაიდერებთან შესაბამისობებს.

შესაბამისი ნომერი ვერ მოიძებნა

თუ ავთენტიფიცირებული ანგარიშისთვის შესაბამისი გაუუქმებელი ჩანაწერი ვერ მოიძებნა, JSON-ის სხეულში მითითებულია status.code 404 და შეტყობინება, რომელიც შეიცავს ტექსტს: number not found. ნუ დაეყრდნობით მის სუფიქსს, რომელიც წყაროს კოდის სტრიქონს მიუთითებს. ხელახლა ცდამდე შეამოწმეთ შენახული ნომერი და inventory.

შედეგის გამოყენება

ეს შენახული მონაცემების წაკითხვაა. ის არ ყიდულობს ნომერს, არ ამტკიცებს პირადობის დამადასტურებელ დოკუმენტებს, არ ცვლის დანიშნულებას და არ იძლევა გარანტიას, რომ ზარი, ფაქსი ან შეტყობინება მიწოდებული იქნება. ნომრის კონფიგურაციისას თითოეული ჩართული სერვისი ცალ-ცალკე შეამოწმეთ.