ПланФикс API action.add
Материал из ПланФикс
Версия от 11:51, 16 декабря 2010; Seva (обсуждение | вклад)
Добавление действия. Неполная версия функции, будет доробатываться:
<?xml version="1.0" encoding="UTF-8"?>
<request method="action.add">
<account></account>
<sid></sid>
<action>
<description></description>
<task>
<id></id>
</task>
<taskNewStatus></taskNewStatus>
<notifiedList>
<user>
<id></id>
<id></id>
<!-- ... -->
</user>
</notifiedList>
<isHidden></isHidden>
</action>
<sirnature></sirnature>
</request>
Название | Тип | Значение | Примечание |
---|---|---|---|
description | string | текст с описанием действия, комментарий | |
task | задача, в рамках которой выполняется это действие | ||
task.id | int | идентификатор задачи | |
taskNewStatus | enum | этим действием меняется статус задачи на указанный | не обязательный параметр, перечень допустимых значений смотри в разделе статусы задач |
notifiedList | этим действием необходимо уведомить следующих пользователей | необязательный параметрполе | |
notifiedList.user | список пользователей которые получат уведомление | ||
notifiedList.user.id | int | идентификатор пользователя | |
isHidden | bool | является ли действие(комментарий) скрытым от всех пользователей, за исключением списка уведомленных пользователей | не обязательное поле, по умолчанию равно 0 (false) |
Результат удачного выполнения запроса:
<?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>