API - это протокол взаимодействия между вашим ПО и нашим сервисом активаций. Он необходим для автоматизации процесса получения СМС на вашей стороне.
Все запросы (только GET) должны идти на данный адрес:
https://365sms.ru/stubs/handler_api.php
Для совместимости с ПО где нет нашего сервиса, добавьте строчку 46.36.219.142 domain в файл C:\Windows\System32\drivers\etc\hosts
Замените domain на домен, который используется в ПО.
https://365sms.ru/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.ru/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.ru/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.ru/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.ru/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.ru/stubs/handler_api.php?api_key=APIKEY&action=getPrices&service=SERVICE&country=COUNTRY
| Параметр | Принимаемые значения | Обязательность | Описание |
|---|---|---|---|
| APIKEY | yo3bPrzepLDAgcU7bFwfvmrvYalMGA | Да | API-ключ обеспечивает доступ к оплаченным услугам |
| SERVICE | См. список сервисов в левом меню | Нет | Сервис, номер для которого необходимо получить |
| COUNTRY | См. список стран в левом меню | Да | Страна номера |
| Ответ сервера | Описание |
|---|---|
| JSON ответ | Ответ в формате { "Страна": { "Сервис": { "Цена": Количество}}} |