Our API does not use URI versioning, meaning, the URI will always just be /api
and the URI will
never be /api/v2
.
We use resource deprecation and sunsetting if we want to phase out an API resource.
We can deprecate a complete resource (such as Partition
), or a method on a resource (such as POST
on Partition
), or a field on a resource (such as partitionName
on
Partition
).
In each case it will be very clear in the API playground that the resource, method, or field is deprecated. It will be clearly marked as such, and the relevant area on the page will be grayed out.
For field deprecations, the field will have a deprecated: true
property in the JSON-LD
schema of the resource.
If a specific URI or method on a URI is to become unresponsive some time in the future, we will set a Sunset
HTTP response header on all responses for that resource, which will communicate the date at which the resource
will be removed.
Any deprecated resources will be very clearly documented in our API Changelog, including deprecation periods and sunset dates.
The API Changelog will still reference version numbers, but that is entirely just for human consumption and ease of reference.
Cannot find the answer to your question? Visit our support page for personalized support by our staff.