ПланФикс API action.update: различия между версиями
Материал из Planfix
SliZzzZ (обсуждение | вклад) |
SliZzzZ (обсуждение | вклад) Нет описания правки |
||
Строка 99: | Строка 99: | ||
</response> | </response> | ||
</source> | </source> | ||
Версия от 12:26, 27 октября 2010
Функция обновления данных в действии. Формат запроса:
<?xml version="1.0" encoding="UTF-8"?>
<request method="action.update">
<account></account>
<sid></sid>
<action>
<id></id>
<description></description>
<timeTracker>
<workDate></workDate>
<beginTime></beginTime>
<endTime></endTime>
<workKind>
<id></id>
<workType>
<id></id>
</workType>
</workKind>
</timeTracker>
<notifiedList>
<user>
<id></id>
<id></id>
<!-- ... -->
</user>
</notifiedList>
<reminder>
<date></date>
</reminder>
</action>
<signature></signature>
</request>
Название | Тип | Значение | Примечание |
---|---|---|---|
id | int | идентификатор действия | |
description | string | текст с описанием действия, комментарий | |
timeTracker | таймтрекер | ||
timeTracker.workDate | DateTime | дата действия | |
timeTracker.beginTime | Time | час начала | |
timeTracker.endTime | Time | час окончания | |
timeTracker.workKind | тип работы | ||
timeTracker.workKind.id | int | идентификатор типа работы | |
timeTracker.workKind.workType | вид выполненной работы | ||
timeTracker.workKind.workType.id | int | идентификатор выполненной работы | |
task | задача, в рамках которой выполняется это действие | ||
task.id | int | идентификатор задачи | |
notifiedList | этим действием необходимо уведомить следующих пользователей | ||
notifiedList.user | список пользователей которые получат уведомление | ||
notifiedList.user.id | int | идентификатор пользователя | |
reminder | необязательный параметр | ||
reminder.date | DateTime | дата когда необходимо уведомить | |
signature | string(32) | подпись |
Помните, можно обновлять действия с типом ACTION и COMMENT. Остальные попытки будут вызывать ошибку.
Результат удачного выполнения запроса:
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
<action>
<id></id>
</action>
</response>
Название | Тип | Значение | Примечание |
---|---|---|---|
action.id | int | идентификатор обновляемого действия |
В противном случае будет возвращен ответ с ошибкой:
<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
<code></code>
</response>