goalsmanagement.task.add
Scope:
goalsmanagementКто может вызывать: Авторизованный с правом постановки задачи. Подробнее: Права доступа
Создать задачу модуля сотруднику отдела
HTTP: POST
Побочные эффекты: создаёт задачу Битрикс24
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
departmentId |
int |
да | ID отдела |
userId |
int |
нет | ID пользователя |
Возвращаемые данные
Ответ в конверте модуля: result.result — departmentId, userId, created, taskId; result.error. Если у сотрудника нет карточки целей, метод возвращает CARD_NOT_FOUND и задачу не создаёт.
Обработка ошибок
Справочник кодов: error-codes.md.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
ACCESS_DENIED |
Нет права постановки задачи |
VALIDATION_ERROR |
Некорректные параметры или создание задачи отключено в настройках модуля |
CARD_NOT_FOUND |
У сотрудника нет карточки целей |
INTERNAL_ERROR |
Внутренняя ошибка сервера |
Пример запроса (POST)
curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/goalsmanagement.task.add.json" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
--data '{
"departmentId": 12,
"userId": 15
}'
Пример ответа
{
"result": {
"result": {
"departmentId": 12,
"userId": 15,
"created": true,
"taskId": 120
},
"error": null
}
}
См. также
Предыдущая
Следующая