Получить список стран — API SMSCash
Возвращает все включённые страны, в том числе без доступных номеров.
SMSCashСправочник методов API
Получить список стран
Возвращает все включённые страны, в том числе без доступных номеров.
API-ключ в запросе
GET https://smscash.org/stubs/handler_api.php?api_key=APIKEY&action=getCountries| Параметр | Тип | Обязательность | Описание | Пример |
|---|---|---|---|---|
| api_key | string | Обязательный | API-ключ. Также можно передать в заголовке X-API-Key или Authorization: Bearer. | APIKEY |
| action | string | Обязательный | Название метода | getCountries |
| provider_id | string | Необязательный | Код или числовой ID поставщика из getProviders. Если передан operator, поставщик должен совпадать. | 1 |
Пример ответа
[
{ "api_code": 43, "code": "AT", "name": "Австрия", "dial_code": "43" },
{ "api_code": 44, "code": "GB", "name": "Великобритания", "dial_code": "44" }
]По умолчанию возвращаются все существующие включённые страны в доступе ключа. При provider_id — страны с номерами выбранного оператора.
Цифровой api_code задаётся в админке отдельно от телефонного кода. У стран с общим телефонным кодом, например +1, разные коды для API.
Оператора можно указать буквенным кодом из getProviders, например alpha, или числовым ID. Регистр букв не важен.
Телефонный код по-прежнему принимается, если он однозначно определяет страну и не занят цифровым кодом для API.
200 — JSON-массив всех включённых стран. Если список пуст, возвращается [].
Ошибки
BAD_KEY — Неверный, отозванный ключ или запрещённый IP. Проверьте ключ, доступ и IP-адрес сервера.
BANNED — Аккаунт заблокирован. Обратитесь в поддержку.
BAD_ACTION — Неизвестный метод или отсутствующий обязательный параметр. Исправьте action и обязательные параметры.
ERROR_RATE_LIMIT — Превышена частота или число одновременных запросов. Снизьте частоту и учтите Retry-After.
ERROR — Временная ошибка сервера. Примените задержку с увеличением интервала; выдачу повторяйте с тем же Idempotency-Key.
BAD_OPERATOR — Оператор не найден. Проверьте getProviders или getOperators.