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.
InterfacesInterfaces
Interfaces en herstelplannen die bestand zijn tegen alledaagse storingen.
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.
InterfacesPaginering 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.
InterfacesEen 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.
InterfacesEen 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