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
7 months ago
4 months ago
In response Patrick Schröder to his Publication
Wir haben letzte Woche eine ähnliche Entscheidung getroffen. Der ausschlaggebende Faktor war für uns die Community-Größe und die langfristige Wartbarkeit.
4 months ago
In response Patrick Schröder to his Publication
Habt ihr auch an die Kosten für Training und Einarbeitung gedacht? Das wird bei Technologie-Entscheidungen oft vergessen.
4 months ago
In response Patrick Schröder to his Publication
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.
