In dit artikel
Een Make-scenario kan dezelfde aanvraag opnieuw uitvoeren, bijvoorbeeld na een time-out. Voor FITsociety-schrijfacties gebruik je daarom een vaste herkenningswaarde voor één wijziging uit je bronsysteem. In de FITsociety-modules kan dit veld Source operation key heten.
Als dezelfde aanvraag met dezelfde sleutel en inhoud wordt herhaald, kan FITsociety de eerdere uitkomst herkennen. Zo verklein je de kans dat een gewone herhaling een tweede wijziging veroorzaakt. Deze herkenning heeft een beperkte bewaartermijn en vervangt geen controle van je scenario.
Een goede sleutel kiezen
Gebruik bij voorkeur het unieke gebeurtenis-ID van de app die je scenario start. Voeg een herkenbare handeling toe. Voorbeelden met fictieve ID's:
Een nieuw CRM-lid aanmaken:
crm:event-123:create-client.Een tag toevoegen na een formulierinzending:
form:submission-456:add-tag.Een extra veld bijwerken na een FITsociety-gebeurtenis: het gebeurtenis-ID met
:update-goal-fielderachter.
Koppel deze waarde aan het daarvoor bedoelde bronveld van de module. Zo blijft hij bij een herhaalde uitvoering gelijk. Gebruik je twee stappen voor verschillende wijzigingen binnen één gebeurtenis? Geef ze een eigen toevoeging, bijvoorbeeld :update-field-a en :update-field-b.
Wanneer hergebruik je de sleutel?
Gebruik dezelfde sleutel én dezelfde invoer wanneer je dezelfde wijziging opnieuw probeert na een storing. Gebruik een nieuwe sleutel voor een werkelijk nieuwe gebeurtenis of wijziging.
Gebruik geen actuele tijd, willekeurig ID of uitvoerings-ID dat bij iedere poging verandert. Gebruik ook niet één vaste waarde voor alle leden. Zet geen namen of e-mailadressen in de sleutel.
Wat doe je bij foutcode 409?
Een foutcode 409 kan betekenen dat een aanvraag nog wordt verwerkt, dat een record al bestaat of dat dezelfde sleutel met andere invoer is gebruikt.
Controleer eerst de eerdere uitvoering en het resultaat in FITsociety. Verander de sleutel niet alleen om de fout te omzeilen; daarmee kun je alsnog een dubbele wijziging veroorzaken. Vergelijk bij een herhaling ook de inhoud van de aanvraag met de oorspronkelijke invoer.
De bewaartermijn en blijvende lidherkenning
De herkenning van Public API-aanvragen op basis van een idempotentiesleutel heeft een bewaartermijn van 24 uur. Dit is geen onbeperkte ontdubbeling van toekomstige uitvoeringen. Houd voor gebeurtenissen die later opnieuw kunnen binnenkomen ook in je scenario of bronsysteem bij welke gebeurtenis-ID's zijn verwerkt.
Biedt je aanmaakmodule een permanent bron-ID voor het lid? Gebruik daar een blijvend lid-ID uit je bronsysteem. Bewaar de relatie met het FITsociety-lid-ID en gebruik voor latere wijzigingen een bijwerkactie. Deze herkenning hoort bij de verleende toegang van je verbinding.
Heb je toegang ingetrokken en daarna opnieuw gekoppeld? Zoek bestaande leden eerst op. Start de oorspronkelijke aanmaakstappen niet zomaar opnieuw: een nieuwe toestemming kan ook een nieuwe toegangscontext betekenen.
Nog geen verbinding? Lees FITsociety koppelen aan Make.