Per iniziare
Errori e tentativi
Interpreta l'envelope di errore JSON standard e decidi quando è sicuro ritentare.
Envelope di errore
Gli errori dell'API JSON usano un unico oggetto error di primo livello con un message leggibile, lo status HTTP numerico e un code stabile facoltativo. Il contratto OpenAPI fa riferimento a questo schema per gli errori previsti e imprevisti.
{
"error": {
"code": "invalid_request",
"message": "A verified From domain is required",
"status": 403
}
}Errori del client
Correggi gli errori di input 400 prima di ritentare. Sostituisci o revoca le credenziali non valide dopo un 401. Un 402 richiede un diritto a pagamento, 403 indica un limite di policy o di permessi, 404 è una risorsa con ambito tenant mancante, 409 è un conflitto di stato o di idempotenza, 413 supera i limiti degli allegati e 422 copre validazione o soppressione.
Quando ritentare
Non ritentare automaticamente in caso di errori di autenticazione, validazione, soppressione o conflitto. Un 423 indica che l'identità From esatta è in pausa: interrompi quel flusso, correggi i destinatari e ritenta solo dopo che le sue metriche mobili sono tornate nella norma. Un chiamante può ritentare una risposta transitoria 429, 502 o 503 con backoff esponenziale limitato e jitter. Quando ritenti un singolo invio logico, mantieni la stessa Idempotency-Key e un payload JSON identico.
Informazioni per il supporto
Registra l'ora della richiesta, la route, lo status HTTP, l'ID della risorsa SendHQ e i campi di errore non segreti. Non includere mai in una segnalazione al supporto una chiave API, un cookie di sessione, il corpo di un messaggio o un elenco di destinatari.