7 months ago
API-Design Lehre aus 3 Jahren Produktion: Versionierung von Tag 1 einplanen. Wir mussten unsere API nachträglich versionieren - das bedeutete 6 Wochen Umbau, 200+ Clients informieren und eine 3-monatige Übergangsphase mit Doppel-Support.
Was wir jetzt anders machen: URL-Versionierung (/v1/, /v2/), Deprecation-Header ab Tag 1, und ein API-Changelog der automatisch aus OpenAPI-Diffs generiert wird. Hätten wir das von Anfang an gehabt, wären uns 2 Monate Arbeit erspart geblieben. #api #backend #architektur
Was wir jetzt anders machen: URL-Versionierung (/v1/, /v2/), Deprecation-Header ab Tag 1, und ein API-Changelog der automatisch aus OpenAPI-Diffs generiert wird. Hätten wir das von Anfang an gehabt, wären uns 2 Monate Arbeit erspart geblieben. #api #backend #architektur
Die Lernkurve ist steil, aber es lohnt sich. Bei uns hat es ca. 4 Wochen gedauert bis das Team produktiv war. Danach ging es steil bergauf.
4 months ago
In response Patrick Schröder to his Publication
