Wat gebeurt er als een API-koppeling stukgaat?
Meestal valt hij gewoon stil. Er verschijnt geen foutmelding op je website en je klanten merken er niets van.
Dat klinkt geruststellend, maar het is precies het probleem. Je ontdekt het pas als iemand iets mist.
Je gegevens zijn vrijwel nooit weg. Ze staan alleen niet op de plek waar je ze verwacht.
Hoe het stilvalt
De koppeling stuurt een verzoek en krijgt een fout terug, of helemaal geen antwoord. Wat er daarna gebeurt, hangt af van hoe hij gebouwd is.
Een nette koppeling probeert het later opnieuw en waarschuwt iemand. Een eenvoudige koppeling doet niets en gaat door met de volgende.
Waarom je het laat merkt
Omdat het aan de zichtbare kant blijft werken. Je webshop neemt bestellingen aan, je klanten krijgen hun bevestiging, alles lijkt in orde.
Alleen komt er in je boekhouding niets binnen. Dat valt op bij de eerste controle, en dat kan weken later zijn.
De meest voorkomende oorzaken
Een verlopen of ingetrokken sleutel. Iemand heeft een wachtwoord gewijzigd of een gebruiker verwijderd, en de koppeling hoort daar niet meer bij.
Verder: een wijziging aan de andere kant, een limiet op het aantal verzoeken, of een verlopen certificaat waardoor de beveiligde verbinding wordt geweigerd.
Mijn vuistregels
- Laat elke koppeling een melding sturen als hij faalt, niet alleen loggen.
- Spreek af wie die melding krijgt en wat diegene dan doet.
- Controleer één keer per maand of de aantallen aan beide kanten kloppen.
- Leg vast welke sleutels waar worden gebruikt.
Die eerste is het verschil tussen een probleem van een uur en een probleem van drie weken.
Wat je vooraf regelt
Bewaking, een melding bij falen, en de afspraak wie er ingrijpt. Dat hoort in je opdracht te staan, niet als losse gedachte achteraf.
Vraag ook of mislukte verzoeken opnieuw worden geprobeerd. Bij een tijdelijke storing lost dat het meeste vanzelf op.
Wat je doet als het gebeurt
Eerst kijken of het aan de sleutel ligt; dat is de meest voorkomende oorzaak en het snelst te controleren. Daarna of de andere partij een storing of een wijziging heeft gemeld.
En dan de achterstand inhalen. Een goede koppeling kan gemiste gegevens alsnog verwerken; anders is het handwerk. Meer over wat dat in beheer betekent lees je bij webhook.