Versioning & Backward compatibility

The API is being versioned. You can use by specifying the appropriate parameter in the request URL. Versioning is divided into major and minor versioning. For your convenience, you can only point to the minor version, as the API may not be compatible between versions. However, we have made sure that the minor versions are backward compatible, so you don't have to worry about which one to use. For example: it doesn't matter if you are going to use version 1.1 or 1.2 you specify v1 in the URL. We made sure that the highest version 1.x is used here and it is compatible with both 1.1 and 1.2.

When creating an API, we assume that major versions will be available for a minimum of one year and no more than two years from the date of release. This means that when creating your programme, you should plan to review changes and update your programme at least once a year. Preferably to the latest version at the time.

If you find a problem or bug, make sure that it also occurs in the latest version of the API and preferably switch to the latest version of the API before reporting it. Some errors will only be fixed in subsequent versions of the API.


Did this page help you?