Outros

API pública do SMS4You: API REST para recepção de SMS, OTP e números virtuais

01/07/2026
API pública do SMS4You: API REST para recepção de SMS, OTP e números virtuais

Conheça a API pública do SMS4You: automatize o recebimento de SMS e o gerenciamento de números

Temos o prazer de anunciar o lançamento do que muitos de vocês esperavam há muito tempo: a API pública do SMS4You. Agora, tudo o que você fazia manualmente na sua conta pessoal pode ser feito por meio de programas: comprar números, receber códigos por SMS e e-mail, acompanhar o saldo e os preços. Seus scripts, bots e sistemas de registro podem interagir diretamente com SMS4You, sem precisar clicar em nada.

A seguir, explicamos o que lançamos exatamente, por que isso é necessário e como começar em cinco minutos.

Resumo do essencial

  • Uma API REST completa para ativações por OTP (recebimento de SMS) e por e-mail.
  • Catálogo de países, serviços e preços atualizados — tudo o que aparece no painel de controle também está disponível via API.
  • Webhooks: os códigos e as mudanças de status chegam automaticamente ao seu servidor, sem a necessidade de consultas constantes.
  • Compatibilidade com o protocolo SMS-Activate: transfira integrações prontas, alterando apenas um endereço.
  • Autenticação simples por meio de um token, que você mesmo cria no seu painel de controle.
  • Documentação interativa com a possibilidade de testar consultas diretamente no navegador.

Para que serve a API

A compra manual de números é boa quando há poucas ativações. Mas, assim que se trata de dezenas e centenas de registros, processamentos em massa ou integração do recebimento de SMS em seu próprio produto, clicar na interface se torna inconveniente. A API resolve exatamente essa tarefa: você define a lógica uma única vez no código e, a partir daí, tudo ocorre automaticamente, em qualquer volume e a qualquer hora do dia.

Cenários típicos para os quais criamos isso:

  • registro e verificação automáticos de contas no seu software;
  • execuções em massa e testes, nos quais são necessários muitos números seguidos;
  • integração do recebimento de códigos por SMS diretamente no seu serviço ou produto;
  • migração de integrações existentes, desenvolvidas para outros provedores.

O que a API oferece

1. Ativações completas: desde a compra do número até o recebimento do código

Todo o ciclo de vida da ativação está disponível por meio de endpoints REST intuitivos:

  • escolher o serviço e o país, verificar a disponibilidade e o preço;
  • comprar um número com uma única solicitação;
  • receber o SMS enviado (ou e-mail, se for ativação por e-mail);
  • concluir, cancelar ou solicitar o reenvio do SMS — o controle do status está totalmente em suas mãos.

Ambos os principais produtos são suportados: recebimento de SMS (OTP) e ativação por e-mail. Cada ativação possui um identificador único, pelo qual você poderá acessá-la posteriormente.

2. Catálogo atualizado e preços

A API fornece dados atualizados:

  • lista de países com códigos de telefone;
  • lista de serviços (para SMS e e-mail);
  • preços por serviço específico ou país, além de uma tabela de preços completa com exibição por página.

Detalhe importante: os preços são apresentados levando em conta seu desconto pessoal. O que você vê na resposta da API é exatamente o valor que será debitado do seu saldo.

3. Webhooks: os códigos chegam até você automaticamente

Consultar constantemente o servidor à espera de SMS é um desperdício e demorado. Por isso, o SMS4You oferece webhooks: assim que uma nova mensagem chega ou o status de ativação é alterado, nós mesmos enviamos uma solicitação HTTP para os endereços indicados por você.

  • você recebe as notificações instantaneamente, sem necessidade de polling;
  • cada chamada é assinada com HMAC, para que você possa ter certeza de que a solicitação é realmente nossa;
  • temos implementadas tentativas repetidas de entrega, caso seu servidor fique indisponível por um segundo;
  • para quem restringe o tráfego por lista de permissões, publicamos a lista de endereços IP de onde os webhooks são enviados.

Juntamente com a API REST, isso completa toda a integração: você mesmo envia as solicitações e recebe as atualizações por canal push.

4. Compatibilidade com o SMS-Activate: migração sem reescrever o código

Além disso, algo de que nos orgulhamos especialmente. Se você já possui um software desenvolvido para a API do SMS-Activate, não precisa reescrever a integração. O SMS4You suporta um protocolo compatível: basta alterar o endereço do servidor para o nosso e inserir sua chave.

Seu código, suas bibliotecas e seus bots existentes continuarão funcionando como estão, mas agora com os números, preços e qualidade do SMS4You. Isso faz com que a migração para nós seja uma questão de apenas uma linha na configuração, e não de semanas de desenvolvimento.

5. Autenticação segura e simples

Sem logins nem senhas nos scripts. Você acessa sua conta pessoal, cria um token pessoal na aba “Token de API” e o utiliza nas solicitações. O token pode ser transmitido de três maneiras — escolha a que for mais conveniente para sua biblioteca:

  • no cabeçalho Authorization: Bearer <токен>;
  • no cabeçalho X-Api-Token: <токен>;
  • parâmetro de consulta ?api_token=<токен>.

É possível criar vários tokens (por exemplo, um para cada projeto) e revogar a qualquer momento um token comprometido, sem afetar os demais. O valor do token é exibido uma única vez durante a criação — depois disso, ele fica armazenado apenas com você.

6. Documentação interativa

Preparamos uma documentação interativa baseada no OpenAPI: cada endpoint está descrito, o tipo de cada campo está indicado e as solicitações podem ser executadas diretamente da página, sem precisar abrir o terminal. Lá também há uma seção separada sobre webhooks e o protocolo compatível com o SMS-Activate.

A documentação está disponível em docs.sms4you.org.

Início rápido em cinco minutos

Endereço básico da API: https://api.sms4you.org/api/v1

Passo 1. Verificamos o saldo e o desconto da conta

curl https://api.sms4you.org/api/v1/me \
  -H "Authorization: Bearer YOU TOKEN"


{
  "data": {
    "name": "Ivan",
    "email": "[email protected]",
    "email_verified": true,
    "balance": "12.3456",
    "currency": "USD",
    "discount_percent": 5
  }
}

Passo 2. Verifique o preço do serviço desejado

curl "https://api.sms4you.org/api/v1/prices?service_id=SERVICE_ID" \
  -H "Authorization: Bearer YOU TOKEN"

Passo 3. Comprar um número

curl -X POST https://api.sms4you.org/api/v1/activations \
  -H "Authorization: Bearer YOU TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"service_id": 123, "country_id": 7, "price": "0.20"}'

Na resposta, você receberá o número de telefone e o código de ativação.

Passo 4. Recebemos o SMS enviado

curl https://api.sms4you.org/api/v1/activations/АКТИВАЦИЯ_ID/messages \
  -H "Authorization: Bearer YOU TOKEN"

E se você configurar um webhook, essa etapa nem será necessária — o código chegará até você automaticamente.

Limites e confiabilidade

  • As solicitações são limitadas em frequência (por padrão, até 120 solicitações por minuto), para que o serviço permaneça estável para todos.
  • Todas as respostas chegam em um formato padronizado, incluindo erros: um código compreensível, uma mensagem legível e, se necessário, detalhes. Processá-las no código é muito fácil.
  • Para compras, é necessário um e-mail confirmado na conta — uma medida de segurança comum.

Para quem é

  • Desenvolvedores que precisam receber SMS dentro de seu produto.
  • Para equipes de arbitragem e marketing, onde os cadastros ocorrem em grande volume.
  • Equipes de QA que testam cenários com verificação por telefone.
  • A todos que já utilizam softwares compatíveis com o SMS-Activate e desejam um provedor sem complicações na migração.

O que vem a seguir

A API pública é a base sobre a qual vamos continuar a construir. Nossos planos incluem ampliar a cobertura de produtos e funcionalidades, atendendo às suas solicitações. Se estiver faltando algum endpoint ou cenário, entre em contato conosco pelo chat de suporte: lemos tudo e priorizamos o que é realmente necessário.

Experimente agora mesmo:

  1. Acesse sua conta pessoal e crie um token na aba “Tokens de API”.
  2. Acesse a documentação em docs.sms4you.org.
  3. Faça a primeira solicitação — e automatize todo o resto.

Boa integração, e que os códigos cheguem na hora certa.