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/. GET o POST Solicitud. Todas las solicitudes deben tener una clave de API en forma de token

Solicitud de saldo

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

Parámetros

Campo	Tipo	Requerido	Valor
`token`	String	yes	Su CLAVE API
`country_id`	Integer	no
`application_id`	Integer	no

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

Parámetros

para seleccionar un país al azar, utilice country_id=0

Campo	Tipo	Requerido	Valor
`token`	String	yes	Su CLAVE API
`country_id`	Integer	no
`application_id`	Integer	yes
`maxPrice`	Integer	no	su valor deseado
`currency`	String	no	`RUB/USD/EUR`
`ref`	String	no	Pasar el ID de referencia
`hasMultipleSms`	String	no	`True/False`

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

Parámetros

Campo	Tipo	Requerido	Valor
`token`	String	yes	Su CLAVE API
`request_id`	Integer	yes	ID de solicitud

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

Parámetros

Campo	Tipo	Requerido	Valor
`token`	String	yes	Su CLAVE API
`request_id`	Integer	yes	ID de solicitud
`status`	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"
}

Obtener precios actuales

Parámetros

Campo	Tipo	Requerido	Valor
`token`	String	yes	Su CLAVE API
`country_id`	Integer	no

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

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

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!"
}