Cadência das chamadas
A API aceita 500 pedidos por minuto e por conta. Acima disso, responde 429 Too Many Requests com os cabeçalhos X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset e Retry-After: aguarde o tempo indicado antes de tentar novamente. Para grandes volumes, agrupe: o envio de uma campanha a uma lista vale uma única chamada, e a API CRM v3 aceita operações em lote sobre os contactos.
Créditos API
Cada conta dispõe de uma quota de créditos API, calculada a partir dos seus créditos de email: ×5 nas subscrições, idêntica nas compras avulsas. As chamadas à API, os webhooks e o OAuth são aí contabilizados. Os eventos api.limit.low e api.limit.reached avisam-o antes e no momento de atingir o limite (eventos webhook).
Está a preparar uma integração de grande volume? Consulte o portal de programadores Mailpro para ver as especificações exatas antes de escalar.
Anexos e tamanho dos pedidos
- Até 5 anexos por email, 10 MB por ficheiro e 15 MB no total.
- Os ficheiros executáveis e scripts (.exe, .bat, .cmd, .js, .vbs, .msi, .jar, .ps1, .dll…) são recusados.
- Os anexos são transmitidos em base64, o que aumenta o seu tamanho em cerca de um terço no pedido.
- Pela entregabilidade, fique abaixo de 10 MB por email e prefira um link de transferência para os ficheiros grandes.
Formatos e autenticação
- API Email v2 e SMS: JSON ou XML, à escolha pela extensão do URL (
.json/.xml). - API CRM v3: JSON, campos em
snake_case(id_sender_email,body_html…). - Autenticação: token Bearer (válido 30 dias, renovável), chave API ou OAuth 2.0. Todas as API respondem apenas em HTTPS.
Códigos de erro e detalhes por endpoint: portal de programadores.
O Mailpro e a API
Para além dos limites da API: envie em grande escala sem surpresas
O SMTP e a API do Mailpro entregam o seu email transacional e de marketing com eventos em tempo real, para que a sua app saiba sempre o que aconteceu.