Versioning, Errors & Compatibility

Current canonical prefix is /api/v1. Legacy unprefixed paths are compatibility routes and carry deprecation metadata.

Strict DTO validation can reject unknown fields. Integrators should retain X-Request-Id when escalating failures.

A stable Partner API should standardize a machine-readable error envelope with code, safe message, request ID and optional details.