2.5 KiB
ms.openlocfilehash, ms.sourcegitcommit, ms.translationtype, ms.contentlocale, ms.lasthandoff, ms.locfileid
| ms.openlocfilehash | ms.sourcegitcommit | ms.translationtype | ms.contentlocale | ms.lasthandoff | ms.locfileid |
|---|---|---|---|---|---|
| dd7c5f37ab5b2d699b47460195e02ae21fca1733 | d2f0b59ed0 |
MT | ru-RU | 11/29/2022 | 148184412 |
REST API {% data variables.product.product_name %} имеет версию. Имя версии API основано на дате выпуска версии API. Например, версия {{ initialRestVersioningReleaseDate }} API была выпущена на {{ initialRestVersioningReleaseDateLong }}.
Все критические изменения будут выпущены в новой версии API. Критические изменения — это изменения, которые потенциально могут нарушить интеграцию. К критическим изменениям относятся:
- удаление всей операции
- удаление или переименование параметра
- удаление или переименование поля ответа
- добавление нового обязательного параметра
- требуется ранее необязательный параметр
- изменение типа параметра или поля ответа
- удаление значений перечисления
- добавление нового правила проверки к существующему параметру
- изменение требований к проверке подлинности или авторизации
Любые аддитивные (не критические) изменения будут доступны во всех поддерживаемых версиях API. Аддитивные изменения — это изменения, которые не должны нарушать интеграцию. К аддитивным изменениям относятся:
- добавление операции
- добавление необязательного параметра
- добавление необязательного заголовка запроса
- добавление поля ответа
- добавление заголовка ответа
- добавление значений перечисления
При выпуске новой версии REST API предыдущая версия API будет поддерживаться еще не менее 24 месяцев после выпуска новой версии API.