LFMail API · v1

Sua caixa, conectada aos seus sistemas.

Consulte mensagens e baixe o e-mail original com uma chave exclusiva para cada integração.

Comece pelo webmail

  1. Abra Configurações → Apps e integrações.
  2. Crie uma chave e escolha a caixa principal ou uma subconta.
  3. Copie a chave uma única vez e guarde-a no servidor do seu sistema.
curl --fail-with-body \
  -H "Authorization: Bearer $LFMAIL_API_KEY" \
  "https://mail.lfmail.com.br/api/v1/messages?limit=25"
mail:read

Uma chave. Uma caixa.

Cada chave tem acesso somente de leitura à caixa escolhida, prazo de validade e revogação imediata. Apelidos entregam na caixa principal. Subcontas mantêm suas mensagens separadas.

Endpoints

  • GET/mailbox
  • GET/messages?limit=25
  • GET/messages/{id}
  • GET/messages/{id}/raw
Baixar especificação OpenAPI

Sincronização previsível

Consulte periodicamente, use limit e position para paginar e salve os IDs já processados. Mudanças na caixa podem deslocar as páginas: deduplique pelo ID. Limite de 60 requisições por minuto por chave e 120 por IP. Em 429, respeite Retry-After; em falhas temporárias, use espera progressiva.

Cuide também da sua integração

Envie a chave apenas no cabeçalho Authorization, por HTTPS. Nunca a inclua em URLs, JavaScript público ou logs. Trate HTML e anexos como conteúdo não confiável. A API não permite enviar, alterar ou excluir mensagens.

Como as mensagens chegam

O endereço @lfmail.com.br recebe pela Cloudflare. O transporte guarda temporariamente a mensagem criptografada, verifica sua assinatura e faz uma verificação de vírus antes de entregar à caixa. O recebimento aceita até 25 MiB por mensagem, incluindo anexos e codificação. Não há envio de e-mails pela API nem notificações webhook para terceiros nesta versão.