Interfaces

Interfaces en herstelplannen die bestand zijn tegen alledaagse storingen.

Kies een API-grens

Een API biedt een verantwoordelijkheid waarop een ander systeem kan vertrouwen. Een bruikbare grens volgt een stabiele bedrijfsfunctie in plaats van de huidige indeling van databasetabellen. Daardoor kan de interne opslag veranderen zonder dat iedere afnemer moet meeveranderen.

Interfaces
Plan een compatibele interfacewijziging

Een interfacewijziging is alleen compatibel ten opzichte van de clients die haar gebruiken. Een extra veld kan een strikte parser laten falen en een extra enumwaarde kan een uitputtende keuzestructuur breken. Compatibiliteit vraagt daarom om bewijs over werkelijk clientgedrag.

Interfaces
Houd paginering consistent

Paginering verdeelt een groot resultaat over kleinere antwoorden. Wanneer gegevens tussen verzoeken veranderen, kan een afnemer een record missen of dubbel ontvangen. De sortering en het consistentiemodel horen bij het interfacecontract.

Interfaces
Deel een tijdsbudget voor de hele keten

Een verzoek kan verschillende diensten doorlopen voordat een antwoord terugkomt. Ruime, onafhankelijke time-outs bij elke stap kunnen de totale wachttijd sterk verlengen. Een deadline maakt het resterende tijdsbudget zichtbaar in de keten.

Interfaces
Behandel een webhook als een onvertrouwd bericht

Een webhook laat een ander systeem een endpoint informeren over veranderingen. Het openbare endpoint ontvangt invoer van buiten zijn vertrouwensgrens. Authenticatie, bescherming tegen herhaling en invoerlimieten horen daarom bij het berichtontwerp.

Interfaces

Zoek in de bibliotheek