სარეგისტრაციო ნომრების ტიპების ჩამონათვალი

აირჩიეთ ტიპი პასუხში დაბრუნებული სახელით

გამოიყენეთ ქვეყანა შემდეგი კატალოგიდან: get_document_countries. დაბრუნებული ტიპის სახელი გადაეცით შემდეგ ფუნქციას: get_requirements. ტიპის კატალოგის იდენტიფიკატორი არ არის პრეფიქსის, ნომრის ან დამადასტურებელი დოკუმენტის კატეგორიის იდენტიფიკატორი.

ჯგუფების რაოდენობა ნომრების მარაგს არ ასახავს

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

მოთხოვნა

გამოიყენეთ თქვენი გააქტიურებული API ანგარიშის ავტორიზაციის მონაცემები HTTPS-ის საშუალებით. მხარდაჭერილია Basic ავთენტიფიკაცია და გააქტიურებული API ანგარიშის bearer ტოკენები; მოქმედებს ანგარიშის შეზღუდვები.

GET მოთხოვნა, რომელშიც ნებისმიერი დოკუმენტირებული პარამეტრი URL-ის გზაშია მითითებული.

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

პასუხი

შეამოწმეთ status.code JSON-ის სხეულში, ასევე HTTP სტატუსი. response არის მასივი, რომელიც შეიცავს შემდეგ ველებს: id, name და available_groups. გამოიყენეთ name როგორც number_type შემდეგი ფუნქციის გამოძახებისას: get_requirements; მის ნაცვლად არ გაგზავნოთ id. available_groups არის ამ ტიპისთვის დაბრუნებული ჯგუფების ჩანაწერების რაოდენობა და არა ტელეფონის ნომრების მარაგის რაოდენობა ან ყველა გვერდის სრული ჯამური რაოდენობა. ტიპები, რომელთათვისაც ჯგუფები არ დაბრუნებულა, გამოტოვებულია. უპირატესი თანმიმდევრობაა Local, Mobile, National, Toll Free, Shared Cost, Global, რასაც კატალოგის სხვა სახელები მოსდევს.

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

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "NUMBER_TYPE_ID_FROM_RESPONSE",
      "name": "Local",
      "available_groups": 3
    }
  ]
}

შეცდომები

• 400: country is required: მიუთითეთ სარეგისტრაციო ქვეყნის ISO კოდი.
• 400: Invalid country ISO or no available DID registration country found: აირჩიეთ ქვეყანა მიმდინარე სარეგისტრაციო კატალოგიდან; ეს არ ადასტურებს, რომ დოკუმენტები საჭირო არ არის.

ხელმისაწვდომობა და თანმდევი მოქმედებები

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