knowledgebase.article.getVersions
Scope:
knowledgebaseКто может вызывать:
IblockRights::elementUserHasRightTo(..., 'element_read')илиIblockRights::canEditElement(). Подробнее: Права доступа
Список версий статьи из ArticleVersionsTable
HTTP: GET
Побочные эффекты: none
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
id |
int |
да | ID статьи (алиасы: articleId, elementId) |
limit |
int |
нет | Размер страницы, по умолчанию 50, максимум 500 |
offset |
int |
нет | Смещение, по умолчанию 0 |
fetchAll |
bool |
нет | Вернуть все записи одним ответом |
Пагинация
limit (default 50, max 500), offset, fetchAll (защитный лимит 5000, иначе FETCH_ALL_LIMIT_EXCEEDED).
Возвращаемые данные
Ответ в конверте модуля: result.result — массив версий; result.next; result.error; верхнеуровневый Bitrix total.
Поля версии: id, elementId, name, dateCreate, createdBy, detailText, extendedTextEditor, contentFormat, tags, sectionIds, disk.
Обработка ошибок
Справочник кодов: error-codes.md.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
VALIDATION_ERROR |
Некорректные или неполные параметры |
ARTICLE_NOT_FOUND |
Статья не найдена |
ACCESS_DENIED |
Нет прав на просмотр версий |
INVALID_LIMIT |
limit вне диапазона 1..500 |
INVALID_OFFSET |
offset < 0 |
FETCH_ALL_LIMIT_EXCEEDED |
При fetchAll=true записей больше защитного лимита (5000) |
INTERNAL_ERROR |
Внутренняя ошибка сервера |
Пример запроса (GET)
curl -G "https://{портал}/rest/{user_id}/{webhook_code}/knowledgebase.article.getVersions.json" \
-H "Accept: application/json" \
--data-urlencode "id=501" \
--data-urlencode "limit=10" \
--data-urlencode "offset=0"
Пример ответа
{
"result": {
"result": [
{
"id": 10,
"elementId": 1073,
"name": "Without text",
"dateCreate": "03.09.2026 15:26:04",
"createdBy": 1,
"detailText": "Version snapshot test",
"extendedTextEditor": "",
"contentFormat": "bb",
"tags": [],
"sectionIds": [],
"disk": []
}
],
"error": null
},
"total": 1
}
См. также
Предыдущая
Следующая