> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Erreurs et comportement de nouvelle tentative

> Format de la charge utile d'erreur, recommandations pour des nouvelles tentatives sûres, et comment associer les nouvelles tentatives aux clés d'idempotence.

# Erreurs et comportement de nouvelle tentative

Les réponses non réussies utilisent cette enveloppe :

```json theme={null}
{
  "error": {
    "code": "SOME_CODE",
    "message": "Human-readable explanation",
    "issues": []
  }
}
```

## Recommandations pour les nouvelles tentatives

* Réessayez en cas d’échecs de transport.
* Réessayez les écritures idempotentes avec la même `Idempotency-Key`.
* Relisez l’état durable après un travail asynchrone au lieu de supposer que la première réponse est complète.

## Règles pratiques

* Considérez les échecs côté serveur comme des candidates aux nouvelles tentatives uniquement lorsque l’écriture initiale utilisait une clé d’idempotence stable.
* Considérez les nouvelles URL de téléchargement d’export comme temporaires et relisez-les via `GET /exports/{exportId}` si nécessaire.
* Si une mutation est déjà en cours ou entre en conflit avec l’état actuel, examinez le `code` renvoyé et ne réessayez que lorsque l’opération reste logiquement sûre.

## Clients lisibles par machine

Le SDK Node.js et la CLI fournis normalisent les erreurs en objets structurés avec :

* `code`
* `message`
* `status`
* `retryable`

Cela permet de faire évoluer la logique d’automatisation en toute sécurité sans analyser des chaînes en texte libre.