Разработчикам

Это раздел с API-документацией для подключения вашего сервиса к SMS-Man и автоматической закупки номеров.

API v2.0

API - это протокол взаимодействия между вашим программным обеспечением и нашим активационным сервером. API необходим для того, чтобы автоматизировать процесс получения SMS-сообщений на вашей стороне. стороне Для работы с API необходимо использовать ваш API-ключ, который вы можете получить, перейдя на страницу профиля страницу. Наше программное обеспечение полностью совместимо с сайтами конкурентов

Описание протокола API

Все запросы должны выполняться http://api.sms-man.ru/control/ POST или GET запрос. Все запросы должны иметь API-ключ в виде token параметра

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

http://api.sms-man.ru/control/get-balance?token=$token

Параметры

Поле Тип Обязательный Значение
token String yes Ваш АПИ ключ

Результат

{"balance":"799.70"}

Возможные ошибки

{"success":false,"error_code":"wrong_token","error_msg": "Wrong token!"}

Получить лимиты

http://api.sms-man.ru/control/limits?token=$token&country_id=$country_id&application_id=$application_id

Параметры

Поле Тип Обязательный Значение
token String yes Ваш АПИ ключ
country_id Integer no
Страна номера
application_id Integer no
Сервис номера

Результат

[{"application_id":"1","country_id":"1","numbers":"32302"},{"application_id":"1","country_id":"2","numbers":"3494"}]

Возможные ошибки

{"success":false,"error_code":"wrong_token","error_msg": {"token": "Wrong token!"}}

Запросить номер телефона

http://api.sms-man.ru/control/get-number?token=$token&country_id=$country_id&application_id=$application_id

Параметры

Поле Тип Обязательный Значение
token String yes Ваш АПИ ключ
country_id Integer no
Страна номера
application_id Integer no
Сервис номера
ref String no Передать реферальный идентификатор

Результат

{"request_id":1,"country_id":1,"application_id":1,"number":"79002415539"}

Возможные ошибки

{"success":false,"error_code":"wrong_token","error_msg": {"token": "Wrong token!"}}

Получить смс

http://api.sms-man.ru/control/get-sms?token=$token&request_id=$request_id

Параметры

Поле Тип Обязательный Значение
token String yes Ваш АПИ ключ
request_id Integer yes ID запроса

Результат

{"request_id":1,"country_id":1,"application_id":1,"number":"79002415539", "sms_code" => "1243"}

Возможные ошибки

{"request_id":1,"country_id":1,"application_id":1,"number":"79002415539", "error_code" => "wait_sms", "error_msg" => "Still waiting..."}

Статус запроса на изменение

http://api.sms-man.ru/control/set-status?token=$token&request_id=$request_id&status=$status

Параметры

Поле Тип Обязательный Значение
token String yes Ваш АПИ ключ
request_id Integer yes ID запроса
status String yes ready / close / reject / used

Результат

{"request_id": 1, "success": true}

Возможные ошибки

{"success":false,"error_code":"wrong_token","error_msg": "Wrong token!"}{"success":false,"error_code":"wrong_status","error_msg": "Status $status does not exists"}

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

http://api.sms-man.ru/control/get-prices?token=$token&country=$country

Параметры

Поле Тип Обязательный Значение
token String yes Ваш АПИ ключ
country_id Integer no
Страна номера

Результат

{"0":{"1":{"cost":"15","count":6455},"2":{"cost":"50","count":124}}, "1":{"3":{"cost":"6","count":1000}}

Возможные ошибки

{"success":false,"error_code":"wrong_token","error_msg": {"token": "Wrong token!"}}

Получить список всех стран

http://api.sms-man.ru/control/countries?token=$token

Параметры

Поле Тип Обязательный Значение
token String yes Ваш АПИ ключ

Результат

[{'id':0,'title':"Russia"}, {'id':3,'title':"China"}]

Возможные ошибки

{"success":false,"error_code":"wrong_token","error_msg": "Wrong token!"}

Получить список всех сервисов

http://api.sms-man.ru/control/applications?token=$token

Параметры

Поле Тип Обязательный Значение
token String yes Ваш АПИ ключ

Результат

[{'id':'1','name':"Vkontakte", "code" => "vk"}, {'id':'2','name':"WeChat", "code" => "wb"}, {'id':'3','name':"Telegram", "code" => "tg"}]

Возможные ошибки

{"success":false,"error_code":"wrong_token","error_msg": "Wrong token!"}
{{country.title}}
{{country.id}}
logo {{service.title}}
{{service.id}}