Construir contra Run2Mail

Developer API Documentation

Learn how to create API keys, authenticate requests, create inboxes, fetch messages, and handle common Run2Mail API responses.

Chaves de API Autenticação Pontos finais principais Códigos de erro

Chaves de API

Gere chaves de API do desenvolvedor em seu painel. Cada chave é mostrada por completo apenas uma vez e depois armazenada como um hash seguro para verificação futura.

Crie chaves a partir do seu painel logado.
Mantenha as chaves privadas e armazene-as em seu próprio gerenciador de segredos.
Revogue chaves antigas sempre que um dispositivo, script ou colega de equipe não precisar mais de acesso.

Autenticação

Use um token de portador no cabeçalho de autorização para cada solicitação protegida.

Authorization: Bearer YOUR_API_KEY

Se a chave for inválida, revogada ou ausente, a API responderá com um erro de autenticação.

Pontos finais principais

O fluxo de trabalho mais comum é: inspecionar o usuário autenticado, criar uma caixa de entrada e, em seguida, buscar as mensagens dessa caixa de entrada.

Verifique a conta corrente

curl -X GET "https://run2mail.com/api/v1/me" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Crie uma caixa de entrada

curl -X POST "https://run2mail.com/api/v1/emails/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "random"
  }'

Buscar mensagens da caixa de entrada

curl -X GET "https://run2mail.com/api/v1/emails/example@2mail.lol/messages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Exemplo de resposta JSON

{
  "success": true,
  "data": {
    "email": "example@2mail.lol",
    "messages": []
  }
}

Limitação de taxa

Run2Mail aplica limites de solicitação baseados em plano e limites diários de criação de caixa de entrada para proteger o serviço e manter o acesso à API estável.

Os limites de taxa por minuto dependem do seu plano ativo.
Os limites de criação de e-mail são rastreados separadamente das chamadas de leitura básicas.
O uso é registrado para visibilidade dentro do painel de análise do administrador.

Códigos de erro

401: Credenciais de API ausentes ou inválidas.
403: Acesso bloqueado, restrito ou não permitido para a solicitação.
429: O volume de solicitações excedeu o limite atual.
503: API do desenvolvedor desativada temporariamente pela plataforma.

Capturas de tela da API do painel em breve

Esta área é reservada para futuras capturas de tela do gerenciador de chaves da API e do painel de uso.

API do Desenvolvedor