Коды ошибок REST API модуля ithive.polls

Методы polls.* возвращают ошибки в конверте модуля внутри стандартной обёртки Bitrix REST.

Полный перечень кодов совпадает с Polls\Rest\Constants. На страницах методов указаны релевантные коды; здесь — все коды модуля.

Формат ответа при ошибке

{
          "result": {
            "result": null,
            "error": {
              "code": "NOT_FOUND",
              "message": "Опрос не найден.",
              "details": {
                "id": 999999999
              }
            }
          },
          "time": {
            "start": 1787319176,
            "finish": 1787319176.291281,
            "duration": 0.29128098487854004,
            "processing": 0,
            "date_start": "2026-08-21T16:32:56+03:00",
            "date_finish": "2026-08-21T16:32:56+03:00"
          }
        }

details опционален (часто field, allowed, value).

Общие коды

Код	HTTP (ориентир)	Когда возникает
`UNAUTHORIZED`	401	Пользователь не авторизован
`ACCESS_DENIED`	403	Нет прав на операцию
`PERMISSION_DENIED`	403	Нет прав на конкретную сущность
`VALIDATION_ERROR`	400	Некорректные или неполные параметры
`NOT_FOUND`	404	Сущность не найдена
`INVALID_LIMIT`	400	`limit` вне диапазона 1..500
`INVALID_OFFSET`	400	`offset` < 0
`INVALID_FILTER`	400	Некорректный `filter` или неизвестное поле
`INVALID_FILTER_OPERATOR`	400	Неизвестный оператор фильтра
`FETCH_ALL_LIMIT_EXCEEDED`	400	`fetchAll` превысил защитный лимит
`EXPORT_LIMIT_EXCEEDED`	400	Экспорт превысил лимит событий/ответов (500)
`INTERNAL_ERROR`	500	Внутренняя ошибка сервера

Применимость по типу метода

Коды	Где возможны
`INVALID_LIMIT`, `INVALID_OFFSET`, `INVALID_FILTER`, `INVALID_FILTER_OPERATOR`, `FETCH_ALL_LIMIT_EXCEEDED`	Только list-методы с пагинацией/фильтром (`*.list`, кроме особых случаев ниже)
`INVALID_LIMIT`, `INVALID_OFFSET`, `FETCH_ALL_LIMIT_EXCEEDED`, `INVALID_FILTER` (только формат)	`polls.vote.getRequired` — пагинация; `filter` на сервере не применяется
`NOT_FOUND`, `VALIDATION_ERROR`	Методы с обязательным id (`get`, `update`, `delete`, voting read и т.д.)
`VALIDATION_ERROR` (без `NOT_FOUND`)	`add` — создание без id в запросе
`EXPORT_LIMIT_EXCEEDED`	Только `polls.vote.exportExcel`
`UNAUTHORIZED`, `INTERNAL_ERROR`	Любой метод

Примеры живых ошибок

`INVALID_LIMIT` — polls.vote.list

{
          "result": {
            "result": null,
            "error": {
              "code": "INVALID_LIMIT",
              "message": "Параметр limit должен быть больше нуля.",
              "details": null
            }
          },
          "time": {
            "start": 1787319176,
            "finish": 1787319176.177356,
            "duration": 0.17735600471496582,
            "processing": 0,
            "date_start": "2026-08-21T16:32:56+03:00",
            "date_finish": "2026-08-21T16:32:56+03:00"
          }
        }

`VALIDATION_ERROR` — polls.question.list без voteId

{
          "result": {
            "result": null,
            "error": {
              "code": "VALIDATION_ERROR",
              "message": "Обязательный параметр voteId не указан или некорректен.",
              "details": {
                "field": "voteId"
              }
            }
          },
          "time": {
            "start": 1787319176,
            "finish": 1787319176.381661,
            "duration": 0.38166093826293945,
            "processing": 0,
            "date_start": "2026-08-21T16:32:56+03:00",
            "date_finish": "2026-08-21T16:32:56+03:00"
          }
        }