Versioning policy

The current version is v1 (/api/v1/…). Within v1 only additive changes are made:

• New endpoints, new optional parameters, new response fields, new categories or enum values may appear.
• Existing fields are not removed, renamed or retyped; hata and detay stay.
• A breaking change only ships under a new version prefix (/api/v2/); v1 keeps running alongside for a while.
• An endpoint due for removal is first announced in the changelog and marked deprecated in OpenAPI.

#For your client

• Ignore unknown fields; treat an unknown enum value like "other".
• Keep the difference between null and [] (empty-list rule).
• Machine-readable definition: openapi.json.