`/permanent` Route fuer stabile API URLs
@oc00001428441 @Pavlos_Giannakis @holz
Unsere API Endpunkte sind aktuell versioniert (/api/v0
), was denke ich grundsaetzlich eine gute Sache ist, um bei Bedarf eine neue API Version einzufuehren und die alte fuer eine Uebergangsfrist ohne Routenkonflikte weiter betreiben zu koennen. Fuer einige Routen (z.B. xdf2
oder JSON Schema
Export) wollen wir aber URLs ausgeben, die stabil und immutable sein sollen.
Was haltet ihr davon, wenn wir neben /api/v0
eine neue Route /permanent
oder /stable
anlegen, unter der diese stabilen Routen erreichbar sind? Damit wuerden wir klar kommunizieren, dass sich diese Routen nicht aendern sollen. Ich wuerde die stabilen Routen dann ebenfalls in die OpenAPI Docs mit aufnehmen.