Erreurs et limites

Les erreurs arrivent en JSON avec un code fixe et un message en anglais. Limite : 120 requêtes par minute et par clé, puis 429 avec retry-after.

La référence technique ci-dessous est en anglais, exactement comme les noms et champs apparaissent dans l'API et dans 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.

Champ	Type	Obligatoire	Description
`error`	object	oui
`error.code`	string	oui	Stable machine code, e.g. not_found, rate_limited.
`error.key`	string	oui	Finer stable identifier for programmatic handling.
`error.message`	string	oui	Human-readable English text. Do not branch on it.

Des questions ?