შეძენილი ნომრების სიის მიღება

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

მოთხოვნა

გამოიყენეთ სერვერის მხარეს შენახული API-ს ავტორიზაციის მონაცემები HTTPS-ის მეშვეობით. მაგალითები ავტორიზაციის მონაცემებს გარემოს ცვლადებიდან კითხულობს; ისინი მოქმედ ავტორიზაციის მონაცემებს არ შეიცავს. შეამოწმეთ status.code JSON-ის სხეულში, ასევე HTTP სტატუსი. ძველი სისტემის ეს დამმუშავებლები აპლიკაციის შეცდომის შემთხვევაში HTTP შეცდომის სტატუსს ყოველთვის არ ადგენს.

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

ერთი შენახული ტელეფონის ნომრით გასაფილტრად გამოიყენეთ მისამართის ბილიკის არასავალდებულო ფორმა:

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

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

პასუხი

ველი response წარმატების შემთხვევაში ყოველთვის მასივია, მათ შორის მაშინაც, როცა ბილიკში ერთი ნომერია მითითებული. status.results მასივის სიგრძეს აღნიშნავს.

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

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "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"
      }
    }
  ]
}

გაფილტვრა და გვერდებად დაყოფა

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

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

თუ ანგარიშს არ აქვს შესაბამისი ჩანაწერები, რომლებიც გაუქმებული არ არის, JSON-ის სხეულში ველის status.code მნიშვნელობაა 404, ხოლო შეტყობინება შეიცავს ფრაზას no numbers found. წარმატებული პასუხის სახით ცარიელი მასივი არ ბრუნდება. შეტყობინებას ბოლოში ახლავს წყაროზე მითითება, რომელიც კლიენტებმა არ უნდა გაარჩიონ და გამოიყენონ სტაბილურ იდენტიფიკატორად.

შემდეგი ნაბიჯები

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