Saltar para o conteúdo
HushSMS

API

Gratuita em cada linha, independentemente do prazo. Sem nível empresarial, sem preço por utilizador e sem chamada de vendas.

URL base

https://api.hushsms.com

Autenticação

Autenticação

Passe o token da sua linha como credencial bearer. Os tokens são limitados a uma única linha e podem ser rotacionados a partir do painel.

curl https://api.hushsms.com/v1/lines \
  -H "Authorization: Bearer hs_live_..."

Referência

Endpoints

GET/v1/lines

Lista as linhas do seu token. Devolve número, país, prazo e validade.

POST/v1/lines

Provisiona uma linha. O corpo inclui país, line_type, prazo e pool. Devolve uma fatura em criptomoeda.

GET/v1/lines/{id}/messages

Mensagens recebidas para uma linha, das mais recentes às mais antigas. Os corpos são eliminados após o período de retenção.

POST/v1/lines/{id}/messages

Envia um SMS de saída. Incluído em todos os prazos.

GET/v1/catalog

Stock de países em tempo real, compatibilidade por serviço e preços atuais. Sem autenticação.

DELETE/v1/lines/{id}

Liberta uma linha antecipadamente. Sem reembolso em prazos mensais; pro-rata acima de seis meses.

Push

Webhooks

Cada mensagem recebida é publicada no seu endpoint dentro de um segundo após a chegada, assinada com HMAC-SHA256.

POST /your-endpoint
X-HushSMS-Signature: sha256=...

{
  "event": "message.received",
  "line_id": "ln_8fQ2...",
  "number": "+44 7700 900123",
  "from":   "+44 7700 900987",
  "body":   "Your code is 481920",
  "received_at": "2026-08-13T09:41:02Z"
}

Máquinas

Para agentes de IA

Um catálogo legível por máquina está disponível em https://hushsms.com/v1/catalog/. Devolve stock de países, compatibilidade por serviço e preços atuais em JSON, sem autenticação.

Open the catalog

Devolve o stock de países em tempo real, a compatibilidade por serviço — incluindo os serviços que não funcionam —, os preços atuais com todos os multiplicadores e a tabela de retenção de dados. Não há chave, nem limite de pedidos que valha a pena mencionar, e o CORS está aberto. Se está a construir um agente que precisa de um número de telefone, este é o endpoint a ler.

Um resumo em texto simples de todo o site está em /llms.txt, com o corpus completo em /llms-full.txt.

O catálogo como contrato invocável

Um corpus em texto simples torna o catálogo legível. Não o torna invocável: um agente que leu todas as palavras ainda não conhece a forma dos pedidos, o enum dos slugs de países, nem quais os campos que o servidor ignora, por isso pode descrever um número que não consegue comprar. É nessa lacuna que uma estratégia apenas de conteúdo para.

/openapi.json fecha-a — um documento OpenAPI 3.1 que cobre os três endpoints públicos e não autenticados (ler o catálogo, criar uma encomenda, consultá-la), com os enums de país, prazo e pool gerados a partir do mesmo catálogo que os handlers validam. Também é declarado no cabeçalho do documento como rel="service-desc", para que um cliente que procure uma descrição de serviço a encontre sem que lhe digam onde.

Abrir a descrição OpenAPI

Fontes

Os dados do plano de numeração nesta página — código de marcação, comprimento dos números nacionais, prefixo de tronco e intervalos móveis — são retirados da série ITU-T E.164. O inventário, os preços e as taxas de sucesso medidas são nossos e estão marcados como tal.

Plano de numeração verificado

Obter númeroContacto