SMSCash

Операторы — API SMSCash

Возвращает включённых операторов: каждый код определяет поставщика и страну.

Справочник методов API

Операторы

Возвращает включённых операторов: каждый код определяет поставщика и страну.

API-ключ в запросе

GET https://smscash.org/stubs/handler_api.php?api_key=APIKEY&action=getOperators&country=43
ПараметрТипОбязательностьОписаниеПример
api_keystringОбязательныйAPI-ключ. Также можно передать в заголовке X-API-Key или Authorization: Bearer.APIKEY
actionstringОбязательныйНазвание методаgetOperators
countrystringНеобязательныйКод страны43
provider_idstringНеобязательныйКод или числовой ID поставщика из getProviders. Если передан operator, поставщик должен совпадать.1

Пример ответа

[
  {
    "id": "00000000-0000-4000-a000-000000000001",
    "code": "alpha_gb",
    "name": "Alpha — Великобритания",
    "country": "GB",
    "country_api_code": 43,
    "provider_id": 1,
    "provider_code": "alpha"
  }
]

Передайте code в параметре operator при получении номера. Страна будет выбрана по оператору.

provider_id и provider_code обозначают поставщика, country и country_api_code — страну.

Фильтры country и provider_id необязательны. Без них возвращаются все доступные ключу операторы.

У старых записей без привязки к поставщику code пустой. Такой ID сохраняется только для прежних интеграций; для нового запроса используйте запись с заполненным code.

Ошибки

BAD_KEY — Неверный, отозванный ключ или запрещённый IP. Проверьте ключ, доступ и IP-адрес сервера.

BANNED — Аккаунт заблокирован. Обратитесь в поддержку.

BAD_ACTION — Неизвестный метод или отсутствующий обязательный параметр. Исправьте action и обязательные параметры.

ERROR_RATE_LIMIT — Превышена частота или число одновременных запросов. Снизьте частоту и учтите Retry-After.

ERROR — Временная ошибка сервера. Примените задержку с увеличением интервала; выдачу повторяйте с тем же Idempotency-Key.

BAD_COUNTRY — Страна не найдена, отключена или телефонный код неоднозначен. Передайте api_code или буквенный code из getCountries.

BAD_OPERATOR — Оператор не найден. Проверьте getProviders или getOperators.