Регистрация Вход

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

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

Совместимое API API 2.0 API аренды

API v2.0

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

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

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

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

https://api.sms-man.com/control/get-balance?token=$token

Параметры

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

Результат

{"balance":"799.70"}

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

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

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

https://api.sms-man.com/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!"}}

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

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

Параметры

для выбора рандомной страны используйте country_id=0

Поле	Тип	Обязательный	Значение
token	String	yes	Ваш АПИ ключ
country_id	Integer	no	Страна номера
application_id	Integer	no	Сервис номера
maxPrice	Integer	no	{ydvalue}
currency	String	no	{apireqcurrency}
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!"}}

Получить смс

https://api.sms-man.com/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..."}

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

https://api.sms-man.com/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"}

Получить текущие цены

https://api.sms-man.com/control/get-prices?token=$token&country_id=$country_id

Параметры

Поле	Тип	Обязательный	Значение
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!"}}

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

https://api.sms-man.com/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!"}

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

https://api.sms-man.com/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!"}