Общее


Пример запросов

Специально для вас мы подгтовили несколько примеров для postman

Run in Postman

docs in postmen

Также мы подготовили пакеты для работы с нашим апи

PHP | JS | Python | Ruby | GO

Общее описание

https://onlinesim.ru API предоставляет Вам возможность использовать наш сервис в автоматическом режиме. Для этого необходимо получить API ключ во вкладке «Профиль пользователя» и реализовать в софте примерно следующий порядок действий:

  1. Запросить виртуальный номер, получить TZID (уникальный номер зарегистрированной операции) - метод getNum;
  2. Получить мобильный номер по TZID, ввести номер в форму подтверждения на необходимом сайте (сервисе) – метод getState;
  3. Запустить цикл, который будет проверять поступление ответа - метод getState;
  4. Если ответ верный — завершить операцию – метод setOperationOk;
  5. Если ответ не подошел — запросить уточнение – метод setOperationRevise;
  6. Завершить операцию – метод setOperationOk;

Для того чтобы использовать API, Вам необходимо осуществить POST или GET запрос по протоколу HTTP на указанный URL: https://onlinesim.ru/api/{METHOD_NAME}.php?PARAMETERS&apikey=YOUR_APIKEY&lang=LANGUAGE

Метод Описание
METHOD_NAME название метода из списка функций API
PARAMETERS параметры соответствующего метода API
YOUR_APIKEY ключ доступа, установленный во вкладке «Профиль пользователя».
LANGUAGE язык, не обязательный параметр. de - German, en - English, ru - Russian, zh - Chinese (Simplified)

Общие возвращаемые ответы

Значения параметра RESPONSE общие для всех методов.

json {response: RESPONSE, …, … }

Результат Описание
ACCOUNT_BLOCKED аккаунт заблокирован
ERROR_WRONG_KEY apikey неверный
ERROR_NO_KEY нет apikey
ERROR_NO_SERVICE не указан сервис
REQUEST_NOT_FOUND не указан метода API
API_ACCESS_DISABLED api выключено
API_ACCESS_IP доступ с данного ip выключен в профиле