Errori e limiti

Gli errori arrivano in JSON con un codice fisso e un messaggio in inglese. Limite: 120 richieste al minuto per chiave, poi 429 con retry-after.

Il riferimento tecnico qui sotto è in inglese, esattamente come nomi e campi appaiono nell'API e in Claude.

{"error": {"code": "apikey_scope_fehlt", "message": "This API key does not have the scope 'contacts:write'."}}

BadRequest	Invalid request (`bad_request`, `idempotency_key_invalid`, ...)
Unauthorized	Missing or invalid API key (`unauthorized`)
Forbidden	The key lacks the required scope (`forbidden`, key `apikey_scope_fehlt`), the account is blocked (`account_blocked`), or a plan limit is reached (`limit_reached`).
NotFound	Not found (or belongs to another account)
Conflict	The current state does not allow the action (e.g. `webhook_limit_reached`, `idempotency_in_progress`)
UnprocessableEntity	Idempotency key reused with a different request body or path (`idempotency_key_mismatch`)
RateLimited	Too many requests for this key (120 per minute), code `rate_limited`
ServiceUnavailable	The account status could not be checked (`status_unavailable`). The API deliberately does NOT let the request through (fail-closed); retry in a minute.

Campo	Tipo	Obbligatorio	Descrizione
`error`	object	sì
`error.code`	string	sì	Stable machine code, e.g. not_found, rate_limited.
`error.key`	string	sì	Finer stable identifier for programmatic handling.
`error.message`	string	sì	Human-readable English text. Do not branch on it.

Domande?