Die Lebensdauer einer API hängt weniger vom Code der ersten Version ab als davon, wie lange ältere Clients weiter funktionieren. Mobile Nutzer bleiben oft monatelang bei einer alten App-Version. Deshalb ist das Entfernen eines Feldes oder die Änderung seiner Bedeutung riskant. Sicherer ist es, Felder hinzuzufügen, optionale Parameter zu akzeptieren und Breaking Changes unter einem neuen Versionspfad einzuführen.
Verwenden Sie ein einheitliches Fehlerformat, etwa RFC 9457 (Problem Details). Wenden Sie die Ratenbegrenzung am Eingangspunkt an, bevor die Anwendungslogik läuft. Versehen Sie jede Antwort mit einer Anfrage-ID und protokollieren Sie sie, damit ein Serverprotokoll dem Fehler zugeordnet werden kann, den ein Client gemeldet hat. Diese drei Entscheidungen senken die späteren Kosten für die Korrektur einer veröffentlichten API erheblich.
Planen Sie ein ähnliches Projekt?
Wir besprechen gern, wie sich das Thema des Artikels in Ihrem Produkt umsetzen lässt.
