API v2.0

API é um protocolo de interação entre seu software e nosso servidor de ativação. A API é necessária para automatizar o processo de recebimento de mensagens SMS do seu lado. Para trabalhar com a API, você deve usar sua chave de API; você pode obtê-la acessando a página de perfil. Nosso software é totalmente compatível com sites concorrentes.

Descrição do protocolo API

Todas as solicitações devem ir para https://api.sms-man.com/control/ POST ou GET um pedido. Todas as solicitações devem ter uma chave API no formulário do token parâmetro.

Solicitação de saldo

Parâmetros

Campo	Tipo	Obrigatório	Valor
`token`	String	yes	Sua chave API

Resultado

{
  "balance": "799.70"
}

Possíveis erros

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

Obter limites

Parâmetros

Campo	Tipo	Obrigatório	Valor
`token`	String	yes	Sua chave 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"}
]

Possíveis erros

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

Solicitar um número de telefone

Parâmetros

para selecionar um país aleatório, utilize country_id=0

Campo	Tipo	Obrigatório	Valor
`token`	String	yes	Sua chave API
`country_id`	Integer	no
`application_id`	Integer	yes
`maxPrice`	Integer	no	o valor pretendido
`currency`	String	no	`RUB/USD/EUR`
`ref`	String	no	Passe a ID de indicação
`hasMultipleSms`	String	no	`True/False`

Resultado

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

Possíveis erros

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

Obter SMS

Parâmetros

Campo	Tipo	Obrigatório	Valor
`token`	String	yes	Sua chave API
`request_id`	Integer	yes	ID da solicitação

Resultado

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

Possíveis erros

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

Mude o status do pedido

Parâmetros

Campo	Tipo	Obrigatório	Valor
`token`	String	yes	Sua chave API
`request_id`	Integer	yes	ID da solicitação
`status`	String	yes	`ready` / `close` / `reject` / `used`

Resultado

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

Possíveis erros

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

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

Obtenha preços atuais

Parâmetros

Campo	Tipo	Obrigatório	Valor
`token`	String	yes	Sua chave API
`country_id`	Integer	no

Resultado

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

Possíveis erros

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

Obtenha uma lista de todos os países

Parâmetros

Campo	Tipo	Obrigatório	Valor
`token`	String	yes	Sua chave API

Resultado

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

Possíveis erros

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

Obtenha a lista de todos os serviços

Parâmetros

Campo	Tipo	Obrigatório	Valor
`token`	String	yes	Sua chave API

Resultado

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

Possíveis erros

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