API de SMS para desenvolvedores: receba códigos por HTTP
A API do Flash SMS deixa o seu código fazer o que você faria no painel: comprar um número para um serviço, esperar o SMS chegar e ler o código. Tudo por chamadas HTTP simples, com respostas em texto ou JSON, no mesmo padrão do sms-activate.
- Um endereço só (handler_api.php), com api_key e action, por GET ou POST.
- Ações: getBalance, getPrices, getNumber, getNumberV2, getStatus e setStatus.
- Valores em reais, cobrados do saldo da sua conta, com preço de revendedor.
- Sem SMS, o valor volta para o saldo sozinho, igual no painel.
Passo a passo
API de SMS para desenvolvedores: receba códigos por HTTP
Gere a chave
No painel, em Minha conta, abra API de revenda e clique em Gerar minha chave. Ela aparece uma vez só.
Compre um número
Chame getNumber (resposta em texto) ou getNumberV2 (JSON) com o código do serviço e o país. O valor sai do saldo na hora.
Consulte o status
Chame getStatus a cada 5 a 10 segundos até vir STATUS_OK com o código, ou STATUS_CANCEL.
Finalize ou cancele
Use setStatus com status=6 para finalizar depois do código, ou status=8 para cancelar a partir de 2 minutos.
Como é a integração
Todas as chamadas vão para o mesmo endereço, informando a sua chave em api_key e a ação em action. As respostas seguem o padrão sms-activate: texto curto como ACCESS_BALANCE:50.00 ou STATUS_OK:482913, e JSON nas ações que devolvem listas, como getPrices e getNumberV2.
Como o padrão é conhecido, existem bibliotecas prontas em várias linguagens. Se você já integrou outro fornecedor desse padrão, o trabalho é trocar o endereço e a chave.
O que dá para controlar
- Servidor: server=1, 2 ou 3, os mesmos três fornecedores do painel, com estoques e preços diferentes (server=1 é o Servidor 1 do painel, server=3 é o Servidor 2 e server=2 é o Servidor 3).
- País: country=73 é Brasil; getCountries devolve a lista completa.
- No server=2, números do Brasil: operadora (Claro, Vivo, TIM, Oi e outras) sem custo extra, e DDD com acréscimo de 30%.
- Outro SMS no mesmo número: setStatus com status=3, sem custo, dentro dos 20 minutos.
Regras que valem para a API
- Cada número fica ativo por 20 minutos.
- Se não sair número, nada é cobrado (NO_NUMBERS).
- Cancelar só é liberado 2 minutos depois da compra (EARLY_CANCEL_DENIED antes disso).
- Sem SMS, o valor volta para o saldo mesmo que você não cancele.
Uso permitido
A API serve para verificar contas próprias e legítimas, testar o fluxo de SMS do seu produto e revender o serviço com as mesmas regras. Criar contas em massa, fraude e uso de dados de terceiros são proibidos pelos termos e levam ao bloqueio da chave e da conta.
Dúvidas
Perguntas frequentes
Tem webhook avisando quando o SMS chega?
Não. O padrão é consultar getStatus a cada 5 a 10 segundos até vir o código ou o cancelamento.
Em que moeda são os preços?
Em reais. Em getPrices, o campo cost já é o preço que você paga por número, com o desconto de revendedor.
Preciso de contrato ou mensalidade?
Não. Você recarrega o saldo por Pix, cartão ou cripto e paga só os números usados.
Onde vejo todos os erros possíveis?
Na página da API, com exemplos de cada ação e a lista de respostas.
API e integrações
Continue lendo
Como integrar a API de números virtuais no seu sistema
O fluxo completo, do pedido do número ao código na tela.
Para que serve uma API de números virtuais
Revenda, testes, bots e painéis internos, e o que é proibido.
Revenda de números para WhatsApp: como fazer do jeito certo
Você vende o número para o cliente verificar a conta dele, não a conta pronta.
Como montar um painel de SMS próprio usando a API
Catálogo, compra, tela de espera, histórico e saldo dos seus clientes.
API de número virtual para WhatsApp: o fluxo completo
service=wa, do getNumber ao setStatus, com cada resposta possível.
Como precificar a revenda de números virtuais
Custo do getPrices, margem em percentual e regras para quando o custo muda.
Receba seu primeiro código hoje
Cadastro em menos de um minuto, recarga por Pix, cartão ou cripto e o SMS no painel. Se não chegar, o valor volta.
Criar conta grátis