Integre sua infraestrutura ao seu e-mail temporário.
Crie caixas, consulte mensagens e use o serviço de números temporários para receber SMS.
Autenticação
Gere uma chave em POST /api/keys e envie-a como x-api-key. Depois autentique a caixa e use o token retornado como Bearer token.
POST /api/token
Content-Type: application/json
x-api-key: SUA_CHAVE_DE_API
{
"address": "sua-caixa@dominio.com",
"password": "sua-senha"
}
Consultar mensagens
GET /api/messages x-api-key: SUA_CHAVE_DE_API Authorization: Bearer TOKEN_DE_SESSAO x-temp-email: sua-caixa@dominio.com
SMS Virtual
O catálogo público retorna os países, serviços, disponibilidade e preços atuais para números temporários.
GET /api/sms/countries GET /api/sms/products?country=brazil
Para habilitar reservas pela interface, configure as credenciais privadas e SMS_PUBLIC_PURCHASES_ENABLED=true somente no servidor. O usuário não informa nenhuma chave. Envie em expectedPrice o preço atual do catálogo; a API recusa a reserva se o preço mudar ou o serviço ficar sem estoque.
POST /api/sms/orders
Content-Type: application/json
{
"country": "brazil",
"operator": "any",
"product": "telegram",
"expectedPrice": 1.25
}
GET /api/sms/orders/ID_DO_PEDIDO
x-sms-order-token: TOKEN_RETORNADO_NA_RESERVA
POST /api/sms/orders/ID_DO_PEDIDO/cancel
x-sms-order-token: TOKEN_RETORNADO_NA_RESERVA
Recursos
GET /api/status— status público.GET /api/domains— domínios disponíveis.POST /api/keys— chave de integração exibida uma única vez.POST /api/accounts— criação de caixa.POST /api/token— autenticação da caixa.GET /api/messages— listagem da inbox.GET /api/messages/{id}— detalhes da mensagem.DELETE /api/messages/{id}— remoção autorizada.GET /api/sms/status— informa se as reservas estão disponíveis.GET /api/sms/countries— lista países disponíveis.GET /api/sms/products?country={id}— serviços SMS, estoque e preço.POST /api/sms/orders— reserva paga protegida por chave privada.GET /api/sms/orders/{id}— consulta SMS recebido no pedido.POST /api/sms/orders/{id}/cancel— solicita cancelamento enquanto o pedido estiver ativo e sem SMS recebido.
Mantenha chaves, senhas e tokens no backend da sua aplicação. Não publique credenciais em código frontend ou páginas indexáveis.