single-service activations

Тарифы на одноразовые активации

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

Страны и, для выбранной страны, сервисы с ценой и количеством доступных номеров — список сервисов блока «Купить номер» в личном кабинете. POST с теми же параметрами тоже работает.

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

  • Сервисы разбиты на страницы: count на страницу, page с 1.
  • Цены в USD. С locale_price они пересчитываются в валюту языка lang (ru — RUB, zh — CNY, fr и de — EUR, en — USD), а не в валюту вашего баланса.
  • С ключом избранные страны и сервисы профиля приходят в favorite_countries и favorite_services и убираются из countries и services.
  • Списки кешируются на 60 секунд.

Список сервисов

Параметры

query8
НазваниеТипОписание
countryinteger

Страна, сервисы которой выводятся. Неизвестный код даёт пустой services

По умолчанию:1
countinteger
≥ 1

Сервисов на странице. Значения меньше 1 становятся 1

По умолчанию:30
pageinteger
≥ 1

Страница списка сервисов, начиная с 1. Значения меньше 1 становятся 1

По умолчанию:1
filter_countrystring

Оставляет только страны, название или код которых начинается с этого значения. Значение приводится к нижнему регистру, ведущий + убирается, поэтому на практике оно сравнивается с original или code. Выбранная country остаётся всегда; с filter_service остаются и страны, где есть подходящий сервис

filter_servicestring

Оставляет только сервисы, слаг или название которых содержит это значение (без учёта регистра). Также фильтрует избранные сервисы и оставляет в countries только страны с таким сервисом (плюс выбранную country)

filterstring

Значение по умолчанию для filter_country и filter_service; возвращается в filter

locale_priceinteger

1 — цены в валюте языка lang вместо USD. Читается как логическое значение: 1, true, on, yes включают; 0, false, off, no, пустое или любое другое значение оставляют выключенным

Перечисление:01По умолчанию:0
langstring

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

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

Ответы

200Тарифы или ошибка
Content-Typeapplication/json
Схема
schemaoneOf
Одно из
[0]object
[1]object
[2]object

Примеры

successСтрок: 34

Тарифы для России, без ключа

favorite_countries и favorite_services здесь равны {} и в пример не включены

{
  "response": "1",
  "countries": {
    "_7": {
      "name": "Russia",
      "original": "russia",
      "code": 7,
      "pos": 0,
      "other": false,
      "new": false,
      "enable": true
    }
  },
  "services": {
    "_vkcom": {
      "id": 1,
      "count": 3721,
      "price": "0.55",
      "service": "VKontakte",
      "slug": "vkcom"
    },
    "_telegram": {
      "id": 2,
      "count": "?",
      "price": "1.20",
      "service": "Telegram",
      "slug": "telegram"
    }
  },
  "page": 1,
  "country": 7,
  "filter": "",
  "end": false
}
INTERVAL_CONCURRENT_REQUESTS_ERROR

Слишком много запросов

{
  "response": "INTERVAL_CONCURRENT_REQUESTS_ERROR"
}
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"
}

Примеры кода

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