instellectIdempotentie betekent dat het herhalen van dezelfde bedoelde actie geen extra ongewenst effect veroorzaakt. Gebruik een stabiele actie-identificatie en controle in de uitvoerende service. Een instructie aan het model om “niet dubbel te doen” is geen betrouwbare deduplicatie.
Kies de juiste identiteit voor de actie
Een technisch request-ID dat bij iedere retry verandert, helpt niet om hetzelfde bedoelde werk te herkennen. Maak onderscheid tussen de taak, een specifieke handeling binnen die taak en afzonderlijke pogingen. Bind de handeling aan relevante inhoud of versie. Een bewust gewijzigde opdracht hoort niet per ongeluk als duplicaat van een eerdere actie te worden geweigerd.
Leg deduplicatie bij het effect
De service die de wijziging uitvoert moet kunnen bepalen of diezelfde actie al is verwerkt. Gebruik de mogelijkheden van de bron-API of een passend transactiemechanisme. Alleen vooraf in een losse lijst kijken is bij gelijktijdige requests onvoldoende als beide daarna alsnog uitvoeren. Denk ook na over de bewaartermijn van actiegegevens en het gedrag na een herstart.
Maak onzekerheid zichtbaar in de workflow
Wachtrijen en retries kunnen dezelfde opdracht opnieuw afleveren. Dat hoeft geen probleem te zijn als de uitvoeringslaag er rekening mee houdt. Bij samengestelde acties is elke stap relevant: een dubbele ticketaanmaak voorkomen lost geen dubbele e-mail op. Test gedeeltelijke voortgang en bepaal welke stap hervat mag worden. Zie foutafhandeling voor de bijbehorende statussen.
Verschillende IDs hebben verschillende doelen
| Identificatie | Betekenis | Voorbeeld |
|---|---|---|
| Taak-ID | De volledige gebruikersopdracht | Aanvraag 842 verwerken |
| Actie-ID | Eén bedoelde handeling met vaste inhoud | Conceptnotitie v1 opslaan |
| Poging-ID | Eén technische uitvoerpoging | Tweede request na timeout |
Twee gelijktijdige herhalingen
Een fictieve queue levert dezelfde opdracht tweemaal af. Beide pogingen vragen om één conceptnotitie. De bron of transactielaag herkent dezelfde actie-ID en creëert één notitie. De tweede poging krijgt de bestaande uitkomst terug. De acceptatietest controleert het werkelijke aantal bronobjecten; twee succesvolle HTTP-responses zijn op zichzelf niet fout.
Neem mee naar je team.
- Gebruik dezelfde actie-ID bij een retry van dezelfde handeling.
- Test gelijktijdige pogingen, herstart en verloren bevestiging.
- Controleer de bron op één bedoeld effect.
Met ruimte voor je besluit, eigenaar en testbewijs. Geen e-mailadres nodig.
Bronnen & verantwoording
Technische achtergrond bij dit onderwerp. De keuzetabel, checklist en fictieve voorbeelden zijn een eigen redactionele uitwerking van Instellect. De beschreven patronen zijn geen overzicht van reeds beschikbare productfuncties.
Geraadpleegd op 11 oktober 2026. Een correctie doorgeven? Mail Instellect.