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
Do not automatically retry authentication, validation, suppression, conflict, or 402 subscription_required failures. A 402 means the workspace has no active subscription; choose a plan, then send. A 423 with code sender_paused means the exact From identity is paused. A 423 with code account_paused means the workspace is paused for review: the body includes the measured bounce and complaint rates and the limits they crossed (bounce_rate vs bounce_limit, complaint_rate vs complaint_limit). Stop that stream. A 429 with code daily_limit_reached is the workspace daily ladder, not a short backoff. Wait until resets_at (midnight UTC). Retry-After is the seconds until then. hourly_limit_reached waits until the next UTC hour. gmail_recipient_limit waits until midnight UTC. The refused message was not queued. Other 429 responses (quota_exhausted) wait until that monthly, per-sender, or attachment limit resets. A caller may retry a transient 502 or 503 with bounded exponential backoff and jitter. Preserve the same Idempotency-Key and identical JSON payload when retrying one logical send.
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.