Versioning

Versioning will be specified by the release date of each version, at first and due to the simplicity of the API all calls will be made through the same version. Version changes will be notified by the usual means and will be done automatically as long as they are backward compatible.

Backward compatibility

A version is considered to be backwards compatible with the previous version whenever:

  • Adding endpoints

  • Adding options to call parameters

  • Adding attributes to response resources

  • Do not modifying/removing call parameters or their interpretation

  • Do not modifying endpoint responses

  • Do not deleting endpoints

For this reason it is recommended that if your integration uses schema-based validation of the API be flexible in accepting new attributes in the resources.

Last updated