ipr.history.list
Scope:
iprКто может вызывать: Авторизованный пользователь; выборка ограничена доступными карточками ИПР. Подробнее: Модель доступа
Возвращает список записей истории изменений по карточкам ИПР с поддержкой пагинации и фильтрации.
HTTP: GET
Побочные эффекты: none
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
limit |
int |
нет | Размер страницы, по умолчанию 50, максимум 500 |
offset |
int |
нет | Смещение |
fetchAll |
bool |
нет | Вернуть все записи одним ответом (максимум 5000) |
filter |
object |
нет | Фильтр в mongo-style формате |
Поля filter (Mongo)
| Поле API | Соответствие |
|---|---|
id |
ID записи |
userId |
Пользователь, совершивший изменение |
iprId |
ID карточки ИПР |
elementId |
ID изменённого элемента (может отличаться от iprId, например для дочерней сущности) |
typeElement |
Тип изменённого элемента (внутренний код модуля) |
event |
Код события |
Возвращаемые данные
Массив объектов той же формы, что у ipr.history.get.
Обработка ошибок
Справочник кодов: error-codes.md.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
INTERNAL_ERROR |
Внутренняя ошибка сервера |
INVALID_LIMIT / LIMIT_EXCEEDED / INVALID_OFFSET / INVALID_FILTER / INVALID_FILTER_OPERATOR |
Некорректные параметры пагинации/фильтра |
FETCH_ALL_LIMIT_EXCEEDED |
Превышен лимит fetchAll |
Пример запроса (GET)
curl -G "https://{портал}/rest/{user_id}/{webhook_code}/ipr.history.list.json"
-H "Accept: application/json"
--data-urlencode "filter[iprId]=4201"
Пример ответа
{
"result": {
"result": [
{
"id": 15001,
"userId": 1,
"iprId": 4201,
"elementId": 4201,
"typeElement": "ipr",
"event": "STATUS_CHANGED",
"prop": "STATUS",
"before": "SOGL",
"after": "WORK",
"note": "",
"created": "2026-06-18 12:20:00"
}
],
"total": 1,
"next": null,
"error": null
}
}
См. также
Предыдущая
Следующая