Stable URLs, deliberate change.
The major version is part of every API path. EXDZ adds capabilities without silently changing the meaning of existing fields.
Versioned URLs
The current base URL is https://api.exchangedz.com/v1. A new major version is introduced only when an incompatible contract cannot be delivered safely inside v1.
Compatible changes
EXDZ may make the following changes without creating a new major version:
- Add optional response properties.
- Add new endpoints or optional query parameters.
- Add new asset records, source coverage or documented error codes.
- Improve performance, validation messages and data quality without changing field meaning.
Clients should ignore response properties they do not recognize and should not rely on object-key order.
Deprecation policy
EXDZ publishes the affected path, replacement and target retirement date in the documentation.
Where practical, deprecated responses include deprecation or sunset metadata and a migration link.
The old behavior remains available for a reasonable migration window unless an urgent security or legal issue requires faster action.
The obsolete path is removed only after the communicated sunset date.
Urgent abuse, security, upstream-rights or legal issues can require immediate restriction. EXDZ will communicate those cases as clearly as circumstances allow.