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.

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.

Mis à jour le : 27/08/2026