OXIAE / VIDEOFictief voorbeeld

API-koppeling: hetzelfde bericht mag geen tweede opdracht maken

Een fictieve CRM-aanvraag toont hoe een API-koppeling omgaat met dubbele berichten, ongeldige velden en een time-out waarvan de uitkomst nog onbekend is.

Door Productie: OXIAEGepubliceerd

Met gesproken uitleg en ondertitels. Je start de video zelf.

Lees mee

Transcript

De gesproken uitleg, per hoofdstuk.

0:00Hetzelfde bericht, dezelfde opdracht

Deze uitleg hoort bij ons artikel over API-integratie. Wat gebeurt er wanneer een systeem hetzelfde bericht opnieuw verstuurt, terwijl de eerste opdracht misschien al is aangemaakt?

0:11Twee berichten voor één aanvraag

Een fictieve, goedgekeurde CRM-aanvraag gaat naar de administratie. Het bericht wordt tweemaal aangeboden. Zonder herkenbare referentie kunnen twee conceptopdrachten ontstaan voor precies dezelfde aanvraag.

0:24Een vaste referentie reist mee

Geef de aanvraag een onveranderlijke bronreferentie die ook in de bestemming wordt opgeslagen. Een relatietabel koppelt de klantreferentie aan het juiste bestaande administratieve klantnummer.

0:35Spreek het gegevenscontract af

Alleen goedgekeurde aanvragen mogen door. Verplichte tekst, klantkoppeling en datumformaat worden gecontroleerd. Een ontbrekende klantmatch of ongeldige datum stopt de verwerking en krijgt een duidelijke foutreden.

0:48Herkennen is niet genoeg

Alleen eerst zoeken voorkomt geen dubbele opdracht bij gelijktijdige berichten. De bestemming moet de externe referentie uniek houden, ook wanneer twee verwerkingen op hetzelfde moment starten.

0:59Een time-out is geen bewijs

Na een time-out kan de opdracht al bestaan. Controleer daarom eerst de bestemming op dezelfde referentie. Blijft de uitkomst onbekend, laat een medewerker beoordelen voordat je opnieuw aanmaakt.

1:10Maak de verwerking terugvindbaar

Registreer bronreferentie, verwerkingsstatus en foutreden. Een beheerder moet kunnen zien wat wel is verwerkt en wat nog aandacht vraagt, zonder de hele keten blind te herhalen.

1:21Test meer dan de goede route

Test dubbele en gelijktijdige berichten, ontbrekende velden en een onbekende uitkomst. Controleer ook actuele bronstatus: een oud bericht mag een nieuwere toestand niet terugdraaien.

1:32Ontwerp ook de herhaalroute

Een betrouwbare koppeling heeft dus meer nodig dan een geslaagde overdracht. Het bronartikel over API-integratie werkt gegevensafspraken, foutreacties en gecontroleerde herverwerking verder uit.