Registre-se Entrar

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 compatível API 2.0 Alugar API

Alugar API

O API é o protocolo para a comunicação entre o seu software e o nosso servidor de aluguel de número.

Descrição do protocolo API

Todas as solicitações devem ir para https://api.sms-man.com/rent-api/ Faça a solicitação. Todas as solicitações devem incluir a chave API como um parâmetro token Todas as respostas estão em formato json.

Requisito de saldo

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

Parâmetros

Parâmetro	Tipo	Obrigatório	Valor
token	string	Sim	Sua chave API

Resultado

{"balance":"799.70"}

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/rent-api/limits?token=$token&country_id=$country_id&type=$type&time=$time

Parâmetros

Parâmetro	Tipo	Obrigatório	Valor
token	string	Sim	Sua chave API
country_id	Integer	Sim	Número do país
type	string	Sim	hora / dia / semana/ mês
time	string	Sim	Tempo de aluguel

Resultado

{"type":"hour","time":"4","limits":[{"country_id":"1","count":"127","cost":"151.68"},{"country_id":"2","count":"49","cost":"113.56"},{"country_id":"4","count":"0","cost":"151.68"}]}

Possíveis erros

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

Solicitando um número para alugar

https://api.sms-man.com/rent-api/get-number?token=$token&country_id=$country_id&type=$type&time=$time

Parâmetros

Parâmetro	Tipo	Obrigatório	Valor
token	string	Sim	Sua chave API
country_id	Integer	Não	Número do país
type	string	Sim	hora / dia / semana/ mês
time	string	Sim	Tempo de aluguel

Resultado

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

Possíveis erros

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

Solicitar um número parcial para aluguel

https://api.sms-man.com/rent-api/get-number?token=$token&country_id=$country_id&type=$type&time=$time&application_id=$application_id&partial=1

Parâmetros

Parâmetro	Tipo	Obrigatório	Valor
token	string	Sim	Sua chave API
country_id	Integer	Não	Número do país
application_id	Integer	Sim	Número do serviço
type	string	Sim	hora / dia / semana/ mês
time	string	Sim	Tempo de aluguel

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

Mudar status

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

Parâmetros

Parâmetro	Tipo	Obrigatório	Valor
token	string	Sim	Sua chave API
request_id	Integer	Sim	ID da solicitação
status	string	Sim	cancelar - cancelamento do aluguel (nos primeiros 20 minutos se o número não recebeu nenhum SMS) / encerrar - cancelar o aluguel

Resultado

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

Possíveis erros

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

Receba a última mensagem de texto

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

Parâmetros

Parâmetro	Tipo	Obrigatório	Valor
token	string	Sim	Sua chave API
request_id	Integer	Sim	ID da solicitação

Resultado

{"request_id":"10","country_id":1,"number":"79633002801","sms": {"message":"message", "code": "code", "time": "2020-12-12 14:50:31"}}

Possíveis erros

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

Receber todos os SMS

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

Parâmetros

Parâmetro	Tipo	Obrigatório	Valor
token	string	Sim	Sua chave API
request_id	Integer	Sim	ID da solicitação

Resultado

{"request_id":"10","country_id":1,"number":"79633002801","sms": [{"message":"message", "code": "code", "time": "2020-12-12 14:50:31"}]}

Possíveis erros

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

Obtenha uma lista de todos os números

https://api.sms-man.com/rent-api/get-all-requests?token=$token

Parâmetros

Parâmetro	Tipo	Obrigatório	Valor
token	string	Sim	Your API KEY

Resultado

[{"id":1,"country_id":1,"number":"79002415539","status":"cancel"}]

Possíveis erros

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

Aceitar