Система PLAN-R динамично развивается, появляется новый функционал, проводится оптимизация внутренних функций и много другой работы влияющей на внутреннее состояние системы, но для того чтобы наши клиенты были защищены от внезапного изменения функционала, мы поддерживаем версионирование нашего публичного API. В течении как минимум шести месяцев будет обеспечиваться неизменность функционала версии API, конечные точки планируемые к удалению помечаются как deprecated и будут удалены через шесть месяцев.
Для указания используемой версии API, нужно добавить в заголовок x-version HTTP запроса номер необходимой Вам версии, например x-version: 409, если тег не указан, то по умолчанию используется максимальная версия API.
Пример:
curl -X 'GET' \
'https://your-org.domain/public-api/eps' \
-H 'accept: application/json;odata.metadata=minimal;odata.streaming=true' \
-H 'Authorization: client-text-token'
-H 'x-version: 409' \
-H 'x-tenant-id: 3fa85f64-5717-4562-b3fc-2c963f66afa6'