# Opérations

> Suivez une commande d'API de son acceptation jusqu'à la fin, et gérez les retards ou les échecs.

Source: https://docs.thalovant.com/fr/developers/operations/

---
{/* Last Edit: Claude Opus 5.5 - 2026-09-28 - Motive: Canadian French translation of developers/operations.mdx. */}

Certaines commandes d'API se poursuivent après le retour de la requête HTTP. Leur réponse inclut un objet `operation` et une URL `links.self`. Attendez que l'opération soit terminée avant d'utiliser la ressource modifiée.

## Séquence d'états

1. **`requested`** signifie que votre commande a été acceptée.
2. **`committed`** signifie que la configuration demandée a été enregistrée.
3. **`applied`** signifie que la configuration a été appliquée; la ressource est peut-être encore en train de démarrer.
4. **`ready`** signifie que la ressource est prête à être utilisée.

`failed` et `timed_out` sont des états finaux. Lisez `error_code` et `error_message` avant de réessayer. Réutilisez la clé d'idempotence d'origine quand vous réessayez après une réponse d'acceptation ambiguë.

## Interroger une opération

```bash
curl --fail-with-body \
  -H "Authorization: Bearer $THALOVANT_TOKEN" \
  https://api.thalovant.com/v1/operations/OPERATION_ID
```

Interrogez avec un délai d'attente croissant et plafonné (backoff). Arrêtez-vous sur `ready`, `failed` ou `timed_out`. Pour les commandes qui ne font qu'enregistrer une configuration, `committed` peut être l'état final. Suivez l'état d'achèvement documenté pour la commande que vous avez appelée.

  Les lectures d'opérations sont privées : vous pouvez lire seulement les opérations lancées par votre propre compte. Un ID inconnu, ou un ID qui appartient à quelqu'un d'autre, renvoie `404` dans les deux cas.

Les clients du plan de contrôle des SDK Python, Node, Go et Rust exposent `get_operation` ou `getOperation`, selon la convention de nommage de leur langage.