# Erreurs et reprises

Interprétez la structure d’erreur stable et réessayez uniquement quand cela est sûr

Canonical: https://alef-bot.top/fr/developers/guides/errors-and-retries

Updated: 2026-07-13

## Structure d’erreur

Chaque erreur API contient error.code, error.message, error.request_id et error.details.resolution_url. Basez-vous sur code plutôt que message

> **Liens de résolution stables.** Ouvrez resolution_url pour une solution ciblée. Les codes inconnus renvoient à ce guide

## Politique de reprise

- Ne réessayez pas les erreurs 401, 403 ou 422 attendues sans modifier la requête
- Réessayez 429 seulement après Retry-After ou X-RateLimit-Reset avec un petit délai aléatoire
- Utilisez un recul exponentiel borné pour les échecs réseau et les erreurs 5xx temporaires
- Après une réponse incertaine à POST /uploads ou POST /transcriptions, réutilisez l’Idempotency-Key initial

## Machine-readable sources

- [OpenAPI JSON](https://alef-bot.top/api/v1/openapi.json)

- [OpenAPI YAML](https://alef-bot.top/api/v1/openapi.yaml)

- [Arazzo workflow](https://alef-bot.top/api/v1/workflows/transcribe.arazzo.yaml)