Page tree
Skip to end of metadata
Go to start of metadata Platform BSS API is versioned in order to provide maximum backwards-compatibility to external applications and allow for maximum flexibility for future expansion.

Setting of API Version

In order to use any of the API methods you will need to provide the version that you like to use.

This is done by appending the 'X-Api-Version' header on each request you make with the version number that you want.

Latest API Version: 2.2

Alternatively, you may use 'latest' keyword as version number in order to be served always with the latest version.

IMPORTANT: Organizations created prior to build 3.21.1

Before build 3.21.1, the definition of 'X-Api-Version' header was not necessary and API Version 1.0 was served as default version.

We keep this functionality unaffected for the organizations created prior to build 3.21.1, but issue may arise in case a newly created organization is used with your implementation.

It is strongly advised to include 'X-Api-Version' header to all your requests with the api version number of your choice, in order to avoid inconsistencies between organizations of an infrastructure.

Version format

API version numbers are in the format major.minor

The major version number changes if changes are made that are incompatible with the previous version

The minor version number changes if functionality is added in a backwards-compatible manner. We skip minor version number for the initial major versions, so there is no 1.0, 2.0 versions but 1, 2. 

The API Versions currently available are 1, 2, 2.1, 2.2

Deprecation Policy

We support all versions of the API for at least 12 months after they are released. We recommend you move to the latest version as soon as you can after a release.

We will give customers 3 months notice of when we deprecate a version of the API.

  • No labels

1 Comment

  1. Stelios Draganidis  Vicky Proikoglou  an to deprication policy mporeite na to yposthrixete, dhladh na enhmerwnete gia na enhmerwnoume tous pelates mas, tote eimai ok. kalo tha htan epishs an mporousate na mou peite pioi pelates xrhsimopoioyn tis depricated methods... exete tetoia statistics akoma kai gia tous onpremise customers mas?