update_task
Метод unit/update_task позволяет редактировать задачи.
svc=unit/update_task¶ms={
"itemId": <long>,
"taskId": <text>,
"props": {
"key1": <long>,
"key2": <text>,
.....
}
}
Пример запроса:
https://hst-api.wialon.com/wialon/ajax.html?sid=5e860dbe24e3d704ffb196d0733ec714&svc=unit/update_task¶ms={
"itemId": 1514,
"taskId": "6f6aeeebad9ebe64bda86924f8d379d8e6b06bd690c53da4aab526c5e221bdb266b52a50",
"props": {
"task_status": 2,
"task_priority": 3
}
}
Параметры
Требуются следующие параметры:
Параметр | Описание |
itemId | Идентификатор объекта. |
taskId | Идентификатор задачи (хэш строки). |
props | Объект свойств, которые необходимо обновить (пары ключ — значение). Указывайте только те свойства, которые вы хотите отредактировать, поскольку каждое новое свойство полностью заменяет соответствующее ему существующее свойство. Ниже приведен список флагов, которые можно использовать в этом параметре для изменения свойств задачи. |
Флаги
Флаг | Описание |
task_status | Статус задачи. Допустимые значения:
|
task_priority | Приоритет задачи. Допустимые значения:
|
task_assignee | Идентификатор пользователя, на которого назначена задача. |
task_comments | Комментарий к задаче. Поле комментария не должно быть пустым или содержать более 500 символов. |
Флаг task_comment должен иметь следующую структуру:
[
{
timestamp: 13243,
assignee: 1564,
comment: "Hello world"
},
{
timestamp: 13244,
assignee: 1564,
comment: "Hello world 2"
}
]
Возвращаемый результат
При успешном выполнении запроса возвращается пустая строка.
{ }
Если запрос не выполнен, возвращается код ошибки. Пример:
{
"error": 5
}
Коды ошибок
Код | Описание |
4 | Невалидные входные параметры. |
5 | Ошибка выполнения запроса. Не удалось найти задачу с указанным индикатором. |
6 | Неизвестная ошибка. |
2008 | Доступ запрещен. Необходимы следующие права доступа:
Эта ошибка также возникает, если не найден указанный идентификатор пользователя, на которого назначена задача. |