Версии API

В этом разделе описаны версии API, способы обращения к методам API с указанием конкретной версии, а так же изменения, которые несут в себе более новые версии API.

№ версии Дата публикации Последнее обновление Доступна до
1.0 30 января 2017 г. — —
2.0 24 мая 2017 г. 7 июня 2017 г. —

Версии 2.0 от 7 июня 2017 г.

нет описания

Версии 2.0 от 24 мая 2017 г.

нет описания

Вызов методов API с указанием версии

Версия API при обращении к методам указывается с помощь URL-параметра api-version. Если при обращении к методу API URL-параметр не задан — обращение будет направлено к последней версии API.

  Пример вызова метода API с указанием версии:

Информация о запросе

GET https://sfa-api.ddapp.biz/api/catalog/products?api-version=1.0

Заголовки запроса (request headers)

Content-Type: application/json
Authorization: bearer eFzNHITIFCxf5EpDXJWZF3GjorGXbmI5lDgYZBscRfpBxzmV57LC5R7jngaSp3-mOxtfNB7_r3PAFkd8jhUkN0pxM2RvKDoepAIV9EEKUR-uwZUdsOzKrB77uO7s5eEqeAMT70aSd8u5BqhB6Mx1WIPlj4tqetL0phv4wGjkLlF7XJBkWYb_02T57bgzwrRnbkIt82NX7kNQ6H3ulJPaQLqlf8jlxVCDHnn89X_XMa5Ti03gwze-lgvNQbIVD03zMi_DRYUgw9jXa6StN1uquc05oLCPxYgF3EYte5aHRABKeDcEIoAtKKo4wJc3kDyXZE6E8nfAQAOPPhdWBeQt7OHs1T24lnyM6NtdiqUa_0Othl8GIyLjcM8-89Sr6opmZSAOUbnLVntnt2lKGkl-H8xVKjAN5iUEBojj56_osMu5We0OLEwCaG-kPoFcsL1_9svBDRYMV0Jm3w3YyMg40c_WZkkB8W8GrpBkV_4TjYDM-DHBV_D6lP4oJg6YGdv4QVqqv8BRZgQMaLDvNeUgiXbWzCUbAzBaj82adMdv4cuAZaHa2dkHjCMaUuP533zb

Authorization — заголовок авторизации. Подробнее узнать о механизмах авторизации можно этом разделе;

Возможные ошибки при работе с версиями API

В случае, если была указана некорректная версия API, которой нет в таблице выше, — сервер вернет ошибку:

HTTP STATUS CODE: 400 (Bad Request)

Тело ответа (response body)

{
   "error":{
      "code":"UnsupportedApiVersion",
      "message":"The HTTP resource that matches the request URI https://sfa-api.ddapp.biz/api/catalog/products?api-version=1.5 does not support the API version '1.5'.",
      "innerError":{
         "message":"No route providing a controller name with API version '1.5' was found to match request URI 'https://sfa-api.ddapp.biz/api/catalog/products?api-version=1.5'."
      }
   }
}