assessment360.assessment.status.list

Scope: assessment360

Кто может вызывать: Авторизованный пользователь REST. Подробнее: Права доступа

Справочник статусов карточки оценки (enum свойства STATUS инфоблока оценок).
Используется для фильтра filter.status в assessment.list и для поля properties.STATUS.xmlId в assessment.get / assessment.list.

HTTP: GET

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

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

Параметр Тип Обяз. Описание
limit int нет Размер страницы, по умолчанию 50, максимум 500
offset int нет Смещение
fetchAll bool нет Вернуть все записи одним ответом (максимум 5000; при превышении — FETCH_ALL_LIMIT_EXCEEDED)
filter object нет Фильтр в mongo-style формате

Поля filter (Mongo)

Поддерживаемые поля элемента справочника: id, code, name
(это поля ответа справочника, не поля карточки оценки).

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

Массив элементов справочника:

Поле Тип Описание
id int ID значения enum в инфоблоке
code string xmlId статуса (то, что передаётся в filter.status)
name string Локализованное название

Типичные значения code: on_approval, assessment_collection, processing_estimates, assessment_completed (набор зависит от установки модуля).

Ответ в конверте модуля: result.result (массив), result.next, result.error, total.

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

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

Код Описание
UNAUTHORIZED Пользователь не авторизован
INTERNAL_ERROR Внутренняя ошибка сервера
INVALID_LIMIT Некорректное значение limit
INVALID_OFFSET Некорректное значение offset
INVALID_FILTER Некорректный фильтр
INVALID_FILTER_OPERATOR Неизвестный оператор фильтра

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

curl -G "https://{портал}/rest/{user_id}/{webhook_code}/assessment360.assessment.status.list.json"
          -H "Accept: application/json"
          --data-urlencode "fetchAll=true"

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

{
          "result": {
            "result": [
              { "id": 117, "code": "on_approval", "name": "На согласовании" },
              { "id": 118, "code": "assessment_collection", "name": "Сбор оценок" },
              { "id": 119, "code": "processing_estimates", "name": "Обработка оценок" },
              { "id": 120, "code": "assessment_completed", "name": "Завершена" }
            ],
            "next": null,
            "error": null
          },
          "total": 4
        }

См. также

Предыдущая
assessment360.assessment.finish
Следующая
assessment360.assessment.tags.get