API de Ativação

Solicitar um número de telefone

Essa requisição destina-se a receber um número virtual. Ela permite definir parâmetros como serviço, operadora e país para obter um número para uso posterior.

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=getNumber&service=SERVICE&operator=OPERATOR&country=COUNTRY

Parâmetros de entrada

Parâmetro	Valores aceitos por este parâmetro	Obrigatório	Descrição
APIKEY	Veja nas configurações da conta	Sim	A chave da API fornece acesso aos serviços pagos.
SERVICE	Veja a lista de serviços no menu à esquerda	Sim	O serviço para o qual você precisa receber um número
OPERATOR	Veja a lista de operadoras no menu à esquerda.	Não	A operadora móvel cujo número você precisa obter
COUNTRY	Veja a lista de países no menu à esquerda.	Sim	O país cujo número você precisa obter
URL	URL completa do webhook (http/https)	Não	Endpoint de webhook. Se informado, enviaremos um POST com os dados do SMS quando chegar um SMS ao número comprado.
MAXPRICE	Número (inteiro ou decimal com ponto)	Não	Se o número comprado custar mais do que o parâmetro enviado, será retornado NO_NUMBERS mesmo que haja números disponíveis.

Resposta do serviço

Resposta do serviço	Exemplo	Descrição
ACCESS_NUMBER:ID:NUMBER	ACCESS_NUMBER:234242:79123456789	Recebemos um número, um ID de ativação e o próprio número com o código do país é NUMBER

Alterar o status

Esta requisição é usada para gerenciar o status do número no sistema.

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=setStatus&status=STATUS&id=ID

Parâmetros de entrada

Parâmetro	Valores aceitos por este parâmetro	Obrigatório	Descrição
APIKEY	Veja nas configurações da conta	Sim	A chave da API fornece acesso aos serviços pagos.
ID	Valor numérico	Sim	ID da ativação recebido ao solicitar um número
STATUS	Valor numérico	Sim	O status que deve ser atribuído ao número

Valores de status disponíveis:

3 - solicitação de reenvio do SMS

6 - ativação concluída com sucesso

8 - ativação cancelada, reembolso efetuado

Resposta do serviço

Resposta do serviço	Descrição
STATUS_WAIT_CODE	Aguardando o recebimento de uma mensagem SMS
ACCESS_ACTIVATION	Ativação concluída com sucesso
ACCESS_CANCEL	Ativação cancelada

Obter um status

Esta requisição é usada para obter o status do número no sistema.

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=getStatus&id=ID

Parâmetros de entrada

Parâmetro	Valores aceitos por este parâmetro	Obrigatório	Descrição
APIKEY	Veja nas configurações da conta	Sim	A chave da API fornece acesso aos serviços pagos.
ID	Valor numérico	Sim	ID da ativação recebido ao solicitar um número

Resposta do serviço

Resposta do serviço	Descrição
STATUS_WAIT_CODE	Aguardando o recebimento de uma mensagem SMS
STATUS_CANCEL	Ativação cancelada
STATUS_OK:CODE	O código recebido (CODE é o código de ativação

Solicitar a quantidade de números disponíveis

A requisição destina-se a obter informações sobre a quantidade disponível de números de telefone.

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=getNumbersStatus&country=COUNTRY&operator=OPERATOR

Parâmetros de entrada

Parâmetro	Valores aceitos por este parâmetro	Obrigatório	Descrição
APIKEY	Veja nas configurações da conta	Sim	A chave da API fornece acesso aos serviços pagos.
COUNTRY	Veja a lista de serviços no menu à esquerda	Sim	O país do número
OPERATOR	Veja a lista de operadoras no menu à esquerda	Não	A operadora do número. Se nenhum parâmetro for especificado, será usada uma operadora aleatória.

Resposta do serviço

Resposta do serviço	Descrição
Resposta JSON	Resposta no formato {"Service_0":"Quantity"}

Solicitar todos os preços

Esta requisição permite obter uma lista de preços disponíveis para este serviço e país. É usada para obter informações atualizadas sobre o custo dos serviços.

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=getPrices&service=SERVICE&country=COUNTRY

Parâmetros de entrada

Parâmetro	Valores aceitos por este parâmetro	Obrigatório	Descrição
APIKEY	Veja nas configurações da conta	Sim	A chave da API fornece acesso aos serviços pagos.
COUNTRY	Veja a lista de países no menu à esquerda	Sim	O país do número
SERVICE	Veja a lista de serviços no menu à esquerda	Não	Serviço necessário

Resposta do serviço

Resposta do serviço	Descrição
Resposta JSON	Resposta no formato {"Country":{"Price":Quanity}}}

Solicitação de saldo

Esta requisição é usada para obter o saldo atual da conta associado à chave de API especificada.

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=getBalance

Parâmetros de entrada

Parâmetro	Valores aceitos por este parâmetro	Obrigatório	Descrição
APIKEY	Veja nas configurações da conta	Sim	A chave da API fornece acesso aos serviços pagos.

Resposta do serviço

Resposta do serviço	Exemplo	Descrição
ACCESS_BALANCE:BALANCE	ACCESS_BALANCE:540	BALANCE - saldo da sua conta

Documentação da API: métodos e solicitações