assessment360.responder.delete

Scope: assessment360

Кто может вызывать: Группы запуска оценки, администратор или HR. См. Права доступа

Удаляет карточку респондента (оценивающего) по её id.
id — ID элемента инфоблока респондентов, не ID карточки оценки.

Выполняет ту же логику, что UI (обнова 11.10.0 / 73610): чистит HL-баллы и ответы, короткую ссылку, удаляет элемент; при статусе filled пересчитывает итоги; для завершённой оценки может откатить статус в processing_estimates и отправить уведомления.

Ограничения (как в модуле):

  • статус оценки: assessment_collection, processing_estimates, assessment_completed
  • роль респондента: не manager и не employee
  • статус респондента — из настройки cardStatusResponders модуля

HTTP: POST

Побочные эффекты: Удаляет карточку респондента и связанные данные оценки.

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

Параметр Тип Обяз. Описание
id int да ID карточки респондента (оценивающего), не ID оценки

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

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

В result.result:

{
          "id": 214,
          "assessmentId": 331,
          "deleted": true
        }

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

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

Код Описание
UNAUTHORIZED Пользователь не авторизован
INTERNAL_ERROR Внутренняя ошибка сервера
VALIDATION_ERROR Параметр id обязателен, либо удаление запрещено статусом/ролью
NOT_FOUND Карточка респондента не найдена
ACCESS_DENIED Недостаточно прав для удаления

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

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/assessment360.responder.delete.json"
          -H "Content-Type: application/json"
          -H "Accept: application/json"
          --data '{
          "id": 214
        }'

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

{
          "result": {
            "result": {
              "id": 214,
              "assessmentId": 331,
              "deleted": true
            },
            "error": null
          }
        }

См. также

Предыдущая
assessment360.responder.update
Следующая
assessment360.answer.list