MultiTEL
Разработчици

GET/v3/get_document_number_types/{country}

Списък на типовете номера за регистрация

Намерете имената на типовете номера, които понастоящем присъстват в каталога за регистрация за дадена държава.

На тази страница
  1. Изберете тип според върнатото му име
  2. Броят на групите не показва наличността на номера
  3. Заявка
  4. Отговор
  5. Грешки
  6. Наличност и странични ефекти

Изберете тип според върнатото му име

Използвайте държава от get_document_countries. Подайте върнатото име на типа на get_requirements. Идентификаторът на тип в каталога не е идентификатор на префикс, на номер или на категория удостоверителни документи.

Броят на групите не показва наличността на номера

available_groups отчита броя на записите за групи, върнати от тази справка в каталога. Той не отчита броя на телефонните номера, които могат да бъдат закупени, не резервира налични номера и не гарантира, че каталогът е обходил всички страници на първичния източник. Потърсете в съответната наличност на номера и разгледайте ценова оферта отделно.

Заявка

Използвайте данните за вход на активирания си API акаунт през HTTPS. Поддържат се удостоверяване чрез Basic и активирани токени от тип bearer за API акаунта; прилагат се ограниченията на акаунта.

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"
Параметри в пътя
ИмеТипЗадължителенОписание
countrystringДаДвубуквен 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: изберете държава от текущия каталог за регистрация; това не означава, че не се изискват документи.

Наличност и странични ефекти

  • Тази справка в каталога или за изискванията не създава самоличност, не качва удостоверителен документ, не регистрира номер и не прави поръчка.
  • Успешният отговор от каталога не представлява одобрение на документите ви или потвърждение, че избраният номер може да бъде активиран.