Розробникам

GET/v3/get_document_countries

Перелік країн реєстрації

Знайдіть ISO-коди та назви країн, доступних у поточному каталозі реєстрації номерів.

На цій сторінці
  1. Виберіть країну реєстрації
  2. Якщо країни немає
  3. Запит
  4. Відповідь
  5. Помилки
  6. Доступність і побічні ефекти

Виберіть країну реєстрації

Скопіюйте ISO-код країни з цієї відповіді, перш ніж запитувати типи номерів або вимоги до реєстрації. Використовуйте країну, у якій надається послуга номера, а не вибирайте автоматично країну громадянства чи адреси клієнта.

Якщо країни немає

Відсутність країни не доводить, що документи не потрібні або що MultiTEL не може надати там номер. Вибирайте параметри реєстрації окремо від пошуку номерів і зверніться до служби підтримки, якщо потрібна країна недоступна.

Запит

Використовуйте облікові дані свого ввімкненого облікового запису API через HTTPS. Підтримуються базова автентифікація та ввімкнені токени доступу облікового запису API, що надають доступ їхньому пред’явнику; діють обмеження облікового запису.

GET із будь-яким задокументованим параметром у шляху URL.

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

Відповідь

Перевіряйте як status.code у тілі JSON, так і статус HTTP. response — це масив із рядками iso та name у верхньому регістрі, відсортований за назвою. Цей каталог реєстрації відрізняється від пошуку наявних номерів і від загального переліку країн, що використовується для адрес. Це не гарантує, що повернуто всі країни або всі доступні сторінки результатів первинного джерела даних.

Приклад структури відповіді; це не фактичні дані облікового запису й не чинна цінова пропозиція.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "iso": "US",
      "name": "United States"
    }
  ]
}

Помилки

  • 500: Unable to load available registration countries: пошук країн реєстрації не надав даних. Повторіть спробу пізніше; не вважайте це успішно отриманим порожнім каталогом.

Доступність і побічні ефекти

  • Цей пошук у каталозі або пошук вимог не створює запису ідентифікації, не завантажує підтвердного документа, не реєструє номера й не оформлює замовлення.
  • Успішна відповідь каталогу не означає схвалення ваших документів і не підтверджує, що вибраний номер можна активувати.