Frequenza delle chiamate
L'API accetta 500 richieste al minuto per account. Oltre, risponde 429 Too Many Requests con gli header X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset e Retry-After: attendete il tempo indicato prima di riprovare. Per grandi volumi, raggruppate: l'invio di una campagna a una lista vale una sola chiamata, e l'API CRM v3 accetta operazioni in blocco sui contatti.
Crediti API
Ogni account dispone di una quota di crediti API, calcolata a partire dai crediti email: ×5 per gli abbonamenti, identica per gli acquisti a consumo. Le chiamate API, i webhook e OAuth vi vengono conteggiati. Gli eventi api.limit.low e api.limit.reached vi avvisano prima e al raggiungimento del limite (eventi webhook).
State preparando un'integrazione ad alto volume? Consultate il portale sviluppatori Mailpro per le specifiche esatte prima di scalare.
Allegati e dimensione delle richieste
- Fino a 5 allegati per email, 10 MB per file e 15 MB in totale.
- I file eseguibili e gli script (.exe, .bat, .cmd, .js, .vbs, .msi, .jar, .ps1, .dll…) vengono rifiutati.
- Gli allegati viaggiano in base64, che ne aumenta la dimensione di circa un terzo nella richiesta.
- Per la deliverability, restate sotto i 10 MB per email e preferite un link di download per i file grandi.
Formati e autenticazione
- API Email v2 e SMS: JSON o XML, a scelta tramite l'estensione dell'URL (
.json/.xml). - API CRM v3: JSON, campi in
snake_case(id_sender_email,body_html…). - Autenticazione: token Bearer (valido 30 giorni, rinnovabile), chiave API oppure OAuth 2.0. Tutte le API rispondono solo in HTTPS.
Codici di errore e dettagli per endpoint: portale sviluppatori.
Mailpro e l'API
Oltre i limiti dell'API: inviate su larga scala senza sorprese
SMTP e API di Mailpro consegnano le vostre email transazionali e di marketing con eventi in tempo reale, così la vostra app sa sempre cosa è successo.