Developer Documentation

API Versioning

API Versioning

Current version: /v1

Rules:

• No breaking changes inside /v1.
• Additive fields are allowed.
• Removed or renamed fields require deprecation headers and changelog entry.
• Mobile app compatibility must be preserved for supported app versions.
• Future /v2 should live beside /v1, not replace it in-place.

Every endpoint change must update OpenAPI, Postman, and docs/changelog.md.