Para desarrolladores

Esta es la sección con la documentación API para conectar su servicio a SMS-Man y la compra automática de números.

API v2.0

API es un protocolo de interacción entre su software y nuestro servidor de activación. La API es necesaria para automatizar el proceso de recepción de mensajes SMS por su parte Para trabajar con la API, debe utilizar su clave de API, puede obtenerla yendo a la página de perfil. Nuestro software es completamente compatible con los sitios de la competencia

Descripción del protocolo API

Todas las solicitudes deben ir a https://api.sms-man.com/control/. HACER o PUBLICAR Solicitud. Todas las solicitudes deben tener una clave de API en forma de token

Solicitud de saldo

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

Parámetros

Campo	Tipo	Requerido	Valor
token	String	yes	Su CLAVE API:

Resultado

{"balance":"799.70"}

Errores posibles

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

Obtener límites

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

Parámetros

Campo	Tipo	Requerido	Valor
token	String	yes	Su CLAVE API:
country_id	Integer	no	País del número
application_id	Integer	no	Número de servicio

Resultado

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

Errores posibles

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

Solicitar un número de teléfono

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

Parámetros

Campo	Tipo	Requerido	Valor
token	String	yes	Su CLAVE API:
country_id	Integer	no	País del número
application_id	Integer	no	Número de servicio
ref	String	no	Pasar el ID de referencia

Resultado

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

Errores posibles

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

Recibir sms

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

Parámetros

Campo	Tipo	Requerido	Valor
token	String	yes	Su CLAVE API:
request_id	Integer	yes	Solicitar ID

Resultado

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

Errores posibles

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

Cambiar el estado de la solicitud

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

Parámetros

Campo	Tipo	Requerido	Valor
token	String	yes	Su CLAVE API:
request_id	Integer	yes	Solicitar ID
estado	String	yes	ready / close / reject / used

Resultado

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

Errores posibles

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

Solicitud de la cantidad de números disponibles

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

Parámetros

Campo	Tipo	Requerido	Valor
token	String	yes	Su CLAVE API:
country_id	Integer	no	País del número

Resultado

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

Errores posibles

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

Obtener lista de todos los países

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

Parámetros

Campo	Tipo	Requerido	Valor
token	String	yes	Su CLAVE API:

Resultado

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

Errores posibles

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

Obtener lista de todos los servicios

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

Parámetros

Campo	Tipo	Requerido	Valor
token	String	yes	Su CLAVE API:

Resultado

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

Errores posibles

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