Para desenvolvedores

Essa é a sessão com documentação API para conectar o seu serviço ao SMS-Man e comprar números automaticamente.

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/ Poste ou obtenha um pedido. Todas as solicitações devem ter uma chave API no formulário do token parameter.

Requisito de saldo

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

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

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

Parâmetros

Campo	Tipo	Obrigatório	Valor
token	String	yes	Sua chave API
country_id	Integer	no	Número do país
application_id	Integer	no	Número do serviço

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

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

Parâmetros

Campo	Tipo	Obrigatório	Valor
token	String	yes	Sua chave API
country_id	Integer	no	Número do país
application_id	Integer	no	Número do serviço
ref	String	no	Passe a ID de indicação

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

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

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

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

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

Solicite a quantidade de números disponíveis

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

Parâmetros

Campo	Tipo	Obrigatório	Valor
token	String	yes	Sua chave API
country_id	Integer	no	Número do país

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

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

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

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

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