single-service activations

Страны с сервисами, ценами и наличием номеров

GEThttps://onlinesim.io/api/getNumbersStats.php

Одна страна с её сервисами, ценами (USD) и количеством доступных номеров; country=all возвращает все страны в виде карты: код страны → страна. В успешном ответе нет поля response. POST с теми же параметрами тоже работает.

Публичный метод: ключ не нужен. Переданный ключ всё равно проверяется (неверный даёт HTTP 456); OAuth-токен, если передан, должен содержать sms-scope.

Ответы кешируются на 60 секунд.

Параметры

query3
НазваниеТипОписание
countrystring

Код страны или all (также 0 или пустое значение) для всех стран

По умолчанию:44
servicestring

Оставляет только сервисы, ключ service_<слаг> которых содержит это значение (без учёта регистра). Работает только для одной страны, при country=all игнорируется

langstring

Язык текстов в ответе (названия стран и сервисов, тексты статусов): fr, de, ru, en или zh. Принимается любым методом; методы без таких текстов отвечают одинаково на любом языке. Названия полей, коды ошибок и другие фиксированные значения остаются на английском. Без параметра: ru для getTariffs, getNumbersStats и getFreeList; в остальных — язык профиля для запросов с ключом, английский для запросов без ключа. Неподдерживаемое значение заменяется языком по умолчанию

Перечисление:frderuenzh

Ответы

200Одна страна, все страны или ошибка
Content-Typeapplication/json
Схема
schemaoneOf
Одно из
[0]object
[1]objectС country=all или country=0: код страны → страна
[2]object
[3]object

Примеры

countryСтрок: 20

Одна страна

{
  "name": "united_kingdom",
  "position": 2,
  "code": 44,
  "other": false,
  "new": false,
  "enabled": true,
  "services": {
    "service_vkcom": {
      "count": 363,
      "popular": false,
      "code": 44,
      "price": 0.36,
      "id": 1,
      "service": "VK",
      "slug": "vkcom"
    }
  },
  "locale_name": "United Kingdom"
}
NO_COUNTRY

Неизвестная страна

{
  "response": "NO_COUNTRY"
}
429HTTP 429: больше 400 запросов в минуту с одного профиля (с одного IP для запросов без ключа) или больше 200 запросов в минуту с одного профиля к getNum, getPrice, getState и setOperationOk вместе
Content-Typeapplication/json
Схема
schemaobject
responsestringОбязательный
Код ошибки. Коды, которые может вернуть любой метод, перечислены во введении; у каждого метода — свои. Список не закрыт: неизвестный код обрабатывайте как общую ошибку и записывайте в лог.

Примеры

Rate limit

Превышен лимит запросов

{
  "response": "TRY_AGAIN_LATER"
}
456HTTP 456: API-ключ неверный или OAuth-токен истёк. Публичные методы отвечают так же, если передан неверный ключ
Content-Typeapplication/json
Схема
schemaobject
responsestringОбязательный
Код ошибки. Коды, которые может вернуть любой метод, перечислены во введении; у каждого метода — свои. Список не закрыт: неизвестный код обрабатывайте как общую ошибку и записывайте в лог.

Примеры

Invalid key

Неверный API-ключ или истёкший токен

{
  "response": "ERROR_WRONG_KEY"
}

Примеры кода

Генерация примеров...