# assessment360.responder.add
Scope:
assessment360Кто может вызывать: Управление карточкой процедуры (
canManageAssessmentCard). См. Права доступа
Создаёт карточку респондента (оценивающего) и привязывает её к карточке оценки.
HTTP: POST
Побочные эффекты: Изменяет состояние данных модуля assessment360.
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
assessmentId |
int |
да | ID карточки оценки |
userId |
int |
да | ID пользователя-респондента (алиас: assessorUserId) |
competencies |
object |
да | Компетенции по типам оценки (см. ниже) |
role |
string |
нет | Роль: employee, manager, collega, subordinate, crm (по умолчанию collega) |
isUserCanSelectColleagues |
bool |
нет | Может ли выбирать коллег |
Структура competencies
Та же карта, что и competentionAssessmentTypeList в assessment360.assessment.start: ключ — тип охвата, значение — int[] (ID компетенций). Нужен хотя бы один ключ с непустым массивом; после фильтра по role должен остаться хотя бы один ID.
Полный список ключей, матрица по ролям и правила взаимоисключения — в разделе «Структура competentionAssessmentTypeList» документа assessment.start.
| Ключ | Тип | Описание |
|---|---|---|
all |
int[] |
Компетенции для всех ролей |
employee_and_head |
int[] |
Сотрудник + руководитель |
employee_and_head_and_subordinates |
int[] |
+ подчинённые (роль subordinate) |
employee_and_head_and_colleagues |
int[] |
+ коллеги (роль collega) |
"competencies": {
"all": [11],
"employee_and_head": [13],
"employee_and_head_and_colleagues": [15]
}
Возвращаемые данные
Ответ возвращается в конверте модуля: result.result, result.next, result.error, total.
Обработка ошибок
Справочник кодов: error-codes.md.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
INTERNAL_ERROR |
Внутренняя ошибка сервера |
VALIDATION_ERROR |
Ошибка валидации (assessmentId / userId / competencies и др.) |
ACCESS_DENIED |
Недостаточно прав для выполнения операции |
Пример запроса (POST)
curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/assessment360.responder.add.json"
-H "Content-Type: application/json"
-H "Accept: application/json"
--data '{
"assessmentId": 331,
"userId": 5,
"role": "collega",
"isUserCanSelectColleagues": false,
"competencies": {
"all": [11],
"employee_and_head": [13],
"employee_and_head_and_colleagues": [15]
}
}'
Пример ответа
{
"result": {
"result": {
"id": 214
},
"next": null,
"error": null
},
"total": 0
}