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