> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.robaws.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Request idempotency

Robaws vous protège contre la création de ressources en double dans un scénario d'échec suivi d'une nouvelle tentative, grâce aux clés d'idempotence. Si vous envoyez deux fois la même requête avec la même clé, l'opération n'est exécutée qu'une seule fois et vous recevez la réponse d'origine. Pour les bases générales de l'API, voyez l'article [API Robaws](https://support.robaws.com/fr/article/api-robaws-whmkou/).

## Envoyer une clé d'idempotence

Fournissez votre propre clé, générée par votre client, via l'en-tête **`Idempotency-Key`**. La valeur doit être unique pour votre user/client id et peut compter maximum 128 caractères.

```
POST https://app.robaws.com/api/v2/work-orders
Authorization: XXX
Idempotency-Key: 8f14e45f-ea4c-4f7a-9a1b-2c3d4e5f6071
```

Les clés d'idempotence ne sont prises en charge que pour **PATCH**, **POST** et **PUT**. Vous pouvez envoyer l'en-tête avec d'autres méthodes HTTP, mais il sera ignoré. Les clés sont limitées par tenant et par utilisateur : deux utilisateurs peuvent donc utiliser sans risque la même valeur de clé.

## Comment la réponse est rejouée

Nous renvoyons toujours la réponse d'origine pour la même clé d'idempotence, mais uniquement si la requête a réussi (aucune erreur 400 ou 500). Lorsque la réponse provient du cache, nous ajoutons l'en-tête **`x-robaws-idempotency-cached-response: true`** pour que vous puissiez distinguer une réponse rejouée d'un nouvel appel.

Les requêtes en échec ne sont jamais mises en cache. Si le premier appel a renvoyé une 400 ou une 500, une nouvelle tentative avec la même clé exécute l'opération à nouveau.

## Requêtes simultanées

Si vous envoyez plusieurs requêtes simultanées avec la même clé d'idempotence, vous pouvez recevoir une **409 CONFLICT**. Sérialisez vos nouvelles tentatives, ou attendez la première réponse avant de réessayer.

Des questions sur votre intégration ? Envoyez un mail à support@robaws.com.