API

API - это протокол взаимодействия между вашим ПО и нашим сервисом активаций. Он необходим для автоматизации процесса получения СМС на вашей стороне.
Все запросы (только GET) должны идти на данный адрес:
https://365sms.org/stubs/handler_api.php

Для совместимости с ПО где нет нашего сервиса, добавьте строчку 46.36.219.142 domain в файл ​​​​​​C:\Windows\System32\drivers\etc\hosts
Замените domain на домен, который используется в ПО.

Запрос количества доступных номеров

https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=getNumbersStatus&country=COUNTRY&operator=OPERATOR

Параметр Принимаемые значения Обязательность Описание
APIKEY yo3bPrzepLDAgcU7bFwfvmrvYalMGA Да API-ключ обеспечивает доступ к оплаченным услугам
COUNTRY См. список стран в левом меню Да Страна номера
OPERATOR См. список операторов в левом меню Нет Оператор номера. Если параметр не задан, будет задействован случайный оператор

Ответ сервиса будет в json формате, пример:
{"vk_0":890,"ok_0":192,"wa_0":146,"vi_0":199,"tg_0":101,"wb_0":103,"go_0":467,"av_0":177,"fb_0":132,"tw_0":479}

Запрос баланса

https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=getBalance

Входные параметры
Параметр Принимаемые значения Обязательность Описание
APIKEY yo3bPrzepLDAgcU7bFwfvmrvYalMGA Да API-ключ обеспечивает доступ к оплаченным услугам

 

Выходные данные
Ответ сервера Пример Описание
ACCESS_BALANCE:BALANCE ACCESS_BALANCE:540 BALANCE - баланс вашего акаунта

 

Возможные ошибки
Ответ сервера Описание
BAD_KEY Неверный API-ключ
ERROR_SQL Ошибка SQL-сервера
BAD_ACTION Неправильное формирование запроса

Заказ номера

https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=getNumber&service=SERVICE&operator=OPERATOR&country=COUNTRY

Входные параметры
Параметр Принимаемые значения Обязательность Описание
APIKEY yo3bPrzepLDAgcU7bFwfvmrvYalMGA Да API-ключ обеспечивает доступ к оплаченным услугам
SERVICE См. список сервисов в левом меню Да Сервис, номер для которого необходимо получить
OPERATOR Принимаемые параметры зависят от конкретной страны. Для уточнения обратите внимание на список операторов в левом меню Нет Сотовый оператор, номер которого необходимо получить
COUNTRY См. список стран в левом меню Да Страна, номер которой необходимо получить

 

Ответы сервиса
Ответ сервера Пример Описание
NO_NUMBERS NO_NUMBERS Нет номеров с заданными параметрами, попробуйте позже, или поменяйте оператора, страну
NO_BALANCE NO_BALANCE Закончились деньги на аккаунте
WRONG_SERVICE WRONG_SERVICE Неверный идентификатор сервиса
ACCESS_NUMBER:ID:NUMBER ACCESS_NUMBER:234242:79123456789 Получили номер, ID активации - ID, сам номер с кодом страны - NUMBER

 

Возможные ошибки
Ответ сервера Описание
BAD_ACTION Неправильное формирование запроса
BAD_SERVICE Некорректное наименование сервиса
BAD_KEY Неверный API-ключ
ERROR_SQL Ошибка базы SQL-сервера

Изменить статус

https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=setStatus&status=STATUS&id=ID

Входные параметры
Параметр Принимаемые значения Обязательность Описание
APIKEY yo3bPrzepLDAgcU7bFwfvmrvYalMGA Да Ваш API-ключ обеспечивает доступ к оплаченным услугам
ID Числовое значение Да ID активации, полученное при запросе номера
STATUS 3 - необходимо повторно смс,
6 - активация успешно завершена,
8 - отменить активацию
Да Статус который необходимо передать номеру

Какой статус когда отправлять?

Сразу после получения номера, номер находится в ожидании SMS.
Вам доступны следующие действия:
8 - Отменить активацию

Сразу после получения кода:
3 - Запросить еще одну смс
6 - Подтвердить SMS-код и завершить активацию

Для активации со статусом 3:
6 - Подтвердить SMS-код и завершить активацию

Выходные данные
Ответ сервера Описание
STATUS_WAIT_CODE Ожидаем прихода СМС
ACCESS_ACTIVATION Активация успешно завершена
ACCESS_CANCEL Активация отменена

 

Возможные ошибки
Ответ сервера Описание
BAD_ACTION Общее неправильное формирование запроса
BAD_SERVICE Некорректное наименование сервиса
BAD_KEY Неверный API-ключ
NO_ACTIVATION ID активации не существует
ERROR_SQL Ошибка базы SQL-сервера, обратитесь к администратору

Получить статус

https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=getStatus&id=ID

Входные параметры
Параметр Принимаемые значения Обязательность Описание
APIKEY yo3bPrzepLDAgcU7bFwfvmrvYalMGA Да API-ключ обеспечивает доступ к оплаченным услугам
ID Числовое значение Да ID активации, полученное при запросе номера

 

Выходные данные
Ответ сервера Описание
STATUS_WAIT_CODE Ожидаем прихода СМС
STATUS_CANCEL Активация отменена
STATUS_OK:CODE Код получен (где CODE - код активации)

 

Возможные ошибки
Ответ сервера Описание
BAD_ACTION Общее неправильное формирование запроса
BAD_KEY Неверный API-ключ
NO_ACTIVATION ID активации не существует
ERROR_SQL Ошибка базы SQL-сервера. Обратитесь к администратору

Запросить все цены

https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=getPrices&service=SERVICE&country=COUNTRY

Входные параметры
Параметр Принимаемые значения Обязательность Описание
APIKEY yo3bPrzepLDAgcU7bFwfvmrvYalMGA Да API-ключ обеспечивает доступ к оплаченным услугам
SERVICE См. список сервисов в левом меню Нет Сервис, номер для которого необходимо получить
COUNTRY См. список стран в левом меню Да Страна номера

 

Выходные данные
Ответ сервера Описание
JSON ответ Ответ в формате { "Страна": { "Сервис": { "Цена": Количество}}}