DOCUMENTAÇÃO

API de e-mail
temporário.

Caixas válidas por 15 minutos. Somente recebimento. API pública, com limite de requisições.

1. Gerar uma caixa

GET /gerar
GET /gerar?domain=kryptonmail.site&user=lucas.silva

Retorna id, email, user, domain, token, created_at, expires_at, ttl_seconds e ttl_minutes. Guarde o token: ele aparece apenas na criação. Sem domain, um domínio é escolhido aleatoriamente.

2. Consultar mensagens

GET /inbox?id=UUID_DA_CAIXA&lite=1
Authorization: Bearer TOKEN_DA_CAIXA

Também aceita email no lugar de id. Para receber body_html, remova lite=1. O modo lite omite HTML e alguns metadados, mas body_text preserva as URLs HTTP/HTTPS dos links de confirmação. A validade não é renovada ao consultar.

3. Ler uma mensagem

GET /message?id=UUID_DA_MENSAGEM
Authorization: Bearer TOKEN_DA_CAIXA

Retorna a mensagem completa, com body_text e body_html. A interface oferece “Texto e URLs” e “Código HTML original”. O HTML é mostrado como código sem executar scripts ou rastreadores. body_html é conteúdo não confiável: nunca insira diretamente na página. Corpos continuam sujeitos ao limite de 200.000 caracteres.

4. Verificar serviço

GET /health

Retorna os domínios configurados e a validade de 900 segundos. As quatro rotas também aceitam o prefixo /api/.

Exemplo cURL

curl 'https://inbox.kryptonmail.site/gerar?domain=kryptonmail.site'

curl 'https://inbox.kryptonmail.site/inbox?id=UUID_DA_CAIXA' \
  -H 'Authorization: Bearer TOKEN_DA_CAIXA'

Limites e erros

Criação: 10 caixas/minuto e 100/hora por IP. Consultas: 240/minuto por IP. SMTP: 1 MiB por mensagem, até 100 mensagens por caixa e 64 conexões simultâneas. Armazenamento de corpos: até 512 MiB no serviço.

Erros retornam status: "error" e message. HTTP 400: parâmetros; 403: token; 404: caixa/mensagem inexistente ou expirada; 409: endereço ocupado; 429: limite; 503: indisponibilidade ou capacidade.

Dados expirados ficam inacessíveis imediatamente e são excluídos do banco em até 30 segundos. Exclusão lógica não garante apagamento forense de discos. Anexos são descartados. Sem envio, relay ou garantia de entrega de terceiros.

O site e a API usam HTTPS. O SMTP desta primeira versão não oferece STARTTLS. Não use para dados sensíveis, recuperação de contas ou informações que precisam ser preservadas. CORS externo não está habilitado: integre pelo seu backend.