library.history.list

Scope: library

Кто может вызывать: Сотрудник; чужие — модератор.

Список записей истории выдачи бумажных книг (HL LibraryBookHistory): книга, заёмщик, даты выдачи и возврата. Сотрудник видит только свои записи; модератор — все.

HTTP: GET

Побочные эффекты: none

Параметры метода

Параметр	Тип	Обяз.	Описание
`limit`	`int`	нет	Размер страницы; по умолчанию 50, максимум 500
`offset`	`int`	нет	Смещение; по умолчанию 0
`fetchAll`	`bool`	нет	Вернуть все строки (защитный лимит `fetchAllMax` из library.schema)
`filter`	`object`	нет	Mongo-style фильтр (`$eq`, `$in`, …); допускается JSON-строка. Алиасы: `listFilter, mongoFilter`

Поля filter (Mongo)

Поле	Алиасы	Описание
`id`	`historyId`	ID записи
`bookId`	—	ID книги
`userId`	—	ID заёмщика
`dateFrom`, `dateTo`, `dateReturn`	—	Даты
`isReturned`	`returned`	Возвращена ли книга

Не-модератор видит только свои записи (фильтр по userId вызывающего).

Возвращаемые данные

Объект выдачи в result.result (list — массив + total, next):

Поле	Тип	Описание
`id`	`int`	ID записи HL
`bookId`	`int`	ID книги
`userId`	`int`	ID заёмщика
`dateFrom`	`string` \| `null`	Дата выдачи
`dateTo`	`string` \| `null`	Плановая дата возврата
`dateReturn`	`string` \| `null`	Фактический возврат
`isReturned`	`bool`	Книга возвращена

Обработка ошибок

Справочник кодов: error-codes.md.

Код	Описание
`UNAUTHORIZED`	Пользователь не авторизован
`ACCESS_DENIED`	Нет доступа к разделу «Библиотека»
`INVALID_LIMIT`	`limit` вне диапазона 1..500
`INVALID_OFFSET`	`offset` < 0
`INVALID_FILTER`	Некорректный `filter` или неизвестное поле (`details.allowed`)
`INVALID_FILTER_OPERATOR`	Неизвестный оператор фильтра
`FETCH_ALL_LIMIT_EXCEEDED`	При `fetchAll=true` записей больше защитного лимита
`INTERNAL_ERROR`	Внутренняя ошибка

Пример запроса (GET)

curl -G "https://76590.dev.wehive.digital/rest/1/{webhook_code}/library.history.list.json" --data-urlencode "limit=2"

Пример ответа

{
          "result": {
            "result": [
              {
                "id": 10,
                "bookId": 1177,
                "userId": 1,
                "dateFrom": "27.08.2026 10:50:31",
                "dateTo": "31.12.2026 00:00:00",
                "dateReturn": "27.08.2026 10:50:32",
                "isReturned": true
              },
              {
                "id": 9,
                "bookId": 1177,
                "userId": 1,
                "dateFrom": "27.08.2026 10:49:58",
                "dateTo": "31.12.2026 00:00:00",
                "dateReturn": "27.08.2026 10:49:58",
                "isReturned": true
              }
            ],
            "error": null
          },
          "next": 2,
          "total": 10
        }