Обновление
Частичное обновление задачи
POST https://do.freshoffice.ru/task/update
Меняются только переданные поля — всё остальное в задаче остаётся как было. Самый частый сценарий — закрыть задачу: передать id, status_id: 2 и текст результата.
Request Body
| Name | Type | Description |
|---|---|---|
| task* | JSON |
200: OK Стандартный объект ответа
{
"status": "success",
"error": "",
"code": null,
"rows": 0,
"pages": 0,
"page": 0,
"value": "5001"
}
JSON
Все доступные параметры
- id - * Код задачи
- note - Текст задачи
- status_id - Статус: 1 — в работе, 2 — выполнена
- result - Результат выполнения (обычно при закрытии)
- type_id - Код вида задачи
- user_id - Код исполнителя
- deal_id - Код сделки
- contact_id - Код контактного лица
- date_start - Дата/время начала
- date_finish - Дата/время завершения
- is_hot - 1 — срочная задача
- tags - Теги через запятую (заменяют старые)
{
"id": 5001,
"status_id": 2,
"result": "Позвонил, условия согласованы, счёт отправлен"
}
Примечание
Обязательный параметр — только id (код задачи) плюс хотя бы одно обновляемое поле.
При закрытии задачи (status_id: 2) автоматически отключается её напоминание. Числовые поля со значением 0 считаются «не переданными», а note, result и tags при передаче полностью заменяют старое значение.
Пример
cURL
NodeJS (Request)
curl --location --request POST 'https://do.freshoffice.ru/task/update' \
--header 'Authorization: Bearer XXXX-XXXXXXX-XXXXXXX' \
--header 'Content-Type: application/json' \
--data-raw '{
"id": 5001,
"status_id": 2,
"result": "Позвонил, условия согласованы, счёт отправлен"
}
'
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://do.freshoffice.ru/task/update',
'headers': {
'Authorization': 'Bearer XXXX-XXXXXXX-XXXXXXX',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"id": 5001,
"status_id": 2,
"result": "Позвонил, условия согласованы, счёт отправлен"
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Ответ
{
"status": "success",
"error": "",
"code": null,
"rows": 0,
"pages": 0,
"page": 0,
"value": "5001"
}
// value - ID обновлённой задачи, 0 - ошибка (текст в поле error)
Предыдущая
Следующая