Эта устаревшая конечная точка возвращает тело в формате {"code", "data"} вместо стандартной оболочки status/response. Она выводит список видимых стран, связанных с каталогом специальных номеров, и не проверяет наличие номеров.
Для новых интеграций:
- Используйте
GET /v3/getcountries, чтобы найти страны с номерами в наличии. - Используйте
GET /v3/other/{isocode}, чтобы узнать, какие типы специальных номеров действительно предлагаются в стране. Даже для страны из этого списка тот запрос может вернуть пустой каталог.
Запрос
Требуется аутентификация HTTP Basic или токен Bearer (см. раздел «Аутентификация и ответы API»). При неудачной аутентификации до выполнения поиска возвращается ответ HTTP 401 в стандартной оболочке.
GET без параметров и без тела запроса.
curl --user "$API_USER:$API_PASSWORD" 'https://api.multitel.net/v3/countries'Ответ
Тело устаревшего формата без стандартной оболочки: {code: 200, data: [...]}. Объект status и поля msg и results отсутствуют. data содержит список стран; порядок не гарантируется. Поля: countrycode (телефонный код страны без '+'), name, description (то же значение, что и у name), isocode, latitude и longitude. Поля is_mobile, sms_coverage и next_function отсутствуют. Страна включается в список, если она видима и связана с каталогом специальных номеров. Наличие номеров не проверяется, поэтому в указанной стране сейчас может не быть доступных номеров. Если ни одна страна не соответствует условиям, data имеет значение null.
Пример структуры ответа; это не актуальные данные учётной записи и не действующее ценовое предложение.
{
"code": 200,
"data": [
{
"countrycode": "33",
"name": "France",
"description": "France",
"isocode": "FR",
"latitude": "46.0000",
"longitude": "2.0000"
}
]
}Ошибки
- 401: Аутентификация отсутствует или не удалась. Ответ отправляется с HTTP status 401 в стандартной оболочке status/response, а не в теле устаревшего формата.
Доступность и побочные эффекты
- Только поиск. Ничего не резервирует, не заказывает и не изменяет.