# Reprises et idempotence

> Ce que la passerelle rejoue pour vous, et ce que vous pouvez rejouer sans risque. Côté produit : Contrôle du trafic et quotas ; côté exploitation : Résilience.

Guide - Depuis la version 0.2.0 - Flexway v1.6.3 - https://flexway.io/docs/developer-retries/

> Ce que la passerelle rejoue pour vous, et ce que vous pouvez rejouer sans risque.
>
> Côté produit : [Contrôle du trafic et quotas](https://flexway.io/docs/product-traffic-quotas/) ; côté exploitation : [Résilience](https://flexway.io/docs/operations-examples-rest/#r%C3%A9silience).

## Ce que la passerelle rejoue

| Règle | Détail |
| --- | --- |
| Méthodes | Idempotentes (`GET`, `HEAD`, `PUT`, `DELETE`), ou toute requête qui porte `Idempotency-Key` |
| Causes | Connexion refusée ou coupée, `502`, `503` de l'API - jamais un `4xx`, jamais un délai de réponse |
| Limites | Au plus deux tentatives, sous un budget de reprises, et **jamais** après le premier octet envoyé |

## Ce que vous pouvez rejouer

| Réponse | Lecture | Écriture |
| --- | --- | --- |
| `429`, `503` | Après `Retry-After` | Après `Retry-After` |
| `502`, `504` | Oui | Seulement avec la **même** `Idempotency-Key`, que l'API (ou le courtier) déduplique |
| `4xx` autre | Non : corrigez la requête | Non |

Envoyez une `Idempotency-Key` unique (un UUID) sur chaque écriture ; elle est relayée à l'API. Sur une
porte de publication, elle peut être **exigée** (`428`) et devient l'`id` de l'évènement.