Описание: Опубликовать новую (мажорную) версию документа. Если у текущей версии ещё не было ни одного "минорного" изменения (т.е. номер минорной версии равен 0) и force_major_update не передан как true, публикация не создаёт новую версию (уже находится в "опубликованном" состоянии) — метод в этом случае ничего не делает.
🌐 HTTP-информация
- Метод:
POST - URL:
/api/document/Publish/{itemId} - Headers:
Content-Type: application/jsonAuthorization: <UserSessionToken>
📥 Параметры запроса (URL Path)
| Параметр | Тип | Описание |
|---|---|---|
itemId | Guid | ID элемента-документа |
📦 Тело запроса (Request Body)
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
checkin_comment | string | Нет | Комментарий к публикации |
force_major_update | bool | Нет | Принудительно создать новую мажорную версию, даже если не было минорных изменений. По умолчанию false |
Пример JSON-тела:
{
"checkin_comment": "Выпуск редакции 2",
"force_major_update": true
}
📤 Тело ответа (Response Body)
IItem — элемент документа (актуальное состояние после публикации, либо без изменений, если публикация не потребовалась).