The API versioning is based on the application version deployed. It follows semver.
During development the server will be 0.X.X, the server endpoint will be prefixed by
Each non retro-compatible API change will imply the major version number to be incremented. Everything will be made to avoid retro incompatible changes.
/ endpoint will redirect to the last API version.
A track of the client version will be kept to know after which date each old version can be shutdown.
The date of the end of support is provided in the API root URL (e.g.
Alert response header, the server can communicate any potential warning
messages, information, or other alerts.
The value is JSON mapping with the following attributes:
code: one of the strings
message: a human-readable message (optional);
url: a URL at which more information is available (optional).
410 Gone error response can be returned if the
client version is too old, or the service had been remplaced with
a new and better service using a new protocol version.