Избранное¶
Добавить в избранное¶
URI: /BumsCommonApiV01/Favorite/add.api|xml
Входные параметры¶
| Поле | Тип | Допустимые значения | Описание |
|---|---|---|---|
| SubjectType | string | task (задача), project (проект), comment (комментарий), event (событие) | Тип объекта |
| SubjectId | integer | ID объекта |
Выходные данные¶
Нет выходных данных
Список избранного¶
URI: /BumsCommonApiV01/Favorite/list.api|xml
Входные параметры¶
| Параметр | Тип | Допустимые значения | Значение по умолчанию | Описание |
|---|---|---|---|---|
| TimeUpdated | string | Дата/время в одном из форматов ISO 8601 | нет | Возвращать только те объекты, которые были изменены после указанный даты |
Выходные данные¶
| Поле | Тип | Описание |
| Tasks | array | Список задач, см. структуру в списке задач |
| Projects | array | Список проектов, см. структуру в списке проектов |
| Events | array | Список событий (структуру см. ниже) |
| To-dos | array | Список дел (структуру см. ниже) |
| Comments | array | Список комментариев (структуру см. ниже) |
Список событий¶
| Поле | Тип | Описание |
|---|---|---|
| Name | string | Название события |
| From | string | Дата начала события |
| To | string | Дата окончания события |
| Participants | array (Id, Name) | Список участников события |
| Owner | object (Id, Name) | Владелец события |
| Description | string | Описание события |
| TImeCreated | string | Время создания события |
Список дел¶
| Поле | Тип | Описание |
|---|---|---|
| Name | string | Название дела |
| TimeFinished | string | Дата завершения дела (если дата пустая, значит дело не завершено) |
| TimeCreated | string | Дата создания дела |
| OrderPos | integer | Порядковый номер дела в списке дел |
| TodoList | object (Id, Name) | Список дел, в котором находится дело |
| Owner | object (Id, Name) | Владелец дела |
| From | string | Дата начала дела. Дата будет пустой, если дело является нераспределенным |
| To | string | Дата окончания дела. Дата будет пустой, если дело является нераспределенным |
Список комментариев¶
| Поле | Тип | Описание |
|---|---|---|
| Text | string | Текст комментария |
| TextHtml | string | Текст комментария в формате HTML |
| Parent | object (Id, Name) | Родительский комментарий |
| TimeCreated | string | Время создани комментария |
| Work | string | Отработанное время |
| WorkDate | string | Дата списания отработанного времени |
Пример ответа в JSON-формате¶
{
"status":
{
"code":"ok",
"message":null
},
"data":
{
"Tasks":
[
{
"Id":841,
"Name":"Test task",
"Status":"cancelled",
"Deadline":"",
"Owner":
{
"Id":3,
"Name":"Ivanov Ivan"
},
"Responsible":
{
"Id":651,
"Name":"Medvedev Dima"
},
"Favorite":"1",
"TimeCreated":"2011-02-08 17:57:51"
}
],
"Projects":
[
{
"Id":847,
"Name":"Test project",
"Statement":"<p>In addition to providing easy access.<\/p>",
"Status":"accepted",
"Deadline":"",
"Owner":
{
"Id":3,
"Name":"Ivanov Ivan"
},
"Responsible":
{
"Id":651,
"Name":"Medvedev Dima"
},
"Favorite":"1",
"TimeCreated":"2011-02-09 18:40:12"
}
],
"Events":
[
{
"Name":"Важная встреча",
"From":"2012-01-05",
"To":"2012-01-06",
"Participants":
[
{
"Id":8736,
"Name":"Ivanov Petr"
}
],
"Owner":
{
"Id":732,
"Name":"Pupkin Vasya"
},
"Description":"Очень важное совещание",
"TimeCreated":"2012-01-01 15:00"
}
],
"To-dos":
[
{
"Name":"Зайти в магазин",
"TimeFinished":"2012-02-02 14:30",
"TimeCreated":"2012-01-01 12:10",
"OrderPos":1,
"TodoList":108,
"Owner":
{
"Id":326,
"Name":"Petrov Petr"
},
"From":"2012-03-03 16:00",
"To":"2012-03-03 17:00"
}
],
"Comments":
[
{
"Text":"Текст комментария",
"TextHtml":"<p>Текст комментария в HTML</p>",
"Parent":
{
"Id":1237,
"Name":"Текст родительского комментария"
},
"TimeCreated":"2012-04-04 13:53",
"Work":"1 час",
"WorkDate":"2012-02-02"
}
]
}
}
Пример ответа в XML-формате¶
<?xml version="1.0" encoding="utf-8"?>
<response>
<status>
<code>ok</code>
<message></message>
</status>
<data>
<tasks>
<item>
<id>841</id>
<name>Test task</name>
<status>cancelled</status>
<deadline></deadline>
<owner>
<id>3</id>
<name>Ivanov Ivan</name>
</owner>
<responsible>
<id>651</id>
<name>Medvedev Dima</name>
</responsible>
<favorite>1</favorite>
<time_created>2011-02-08 17:57:51</time_created>
</item>
</tasks>
<projects>
<item>
<id>847</id>
<name>Test project</name>
<statement><p>In addition to providing easy access.<\/p></statement>
<status>accepted</status>
<deadline></deadline>
<owner>
<id>3</id>
<name>Ivanov Ivan</name>
</owner>
<responsible>
<id>651</id>
<name>Medvedev Dima</name>
</responsible>
<favorite>1</favorite>
<time_created>2011-02-09 18:40:12</time_created>
</item>
</projects>
<events>
<item>
<name>Важная встреча</name>
<from>2012-01-05</from>
<to>2012-01-06</to>
<participants>
<item>
<id>8736</id>
<name>Ivanov Petr</name>
</item>
</participants>
<owner>
<id>732</id>
<name>Pupkin Vasya</name>
</owner>
<description>Очень важное совещание</description>
<time_created>2012-01-01 15:00</time_created>
</item>
</events>
<to-dos>
<item>
<name>Зайти в магазин</name>
<time_finished>2012-02-02 14:30<time_finished>
<time_created>2012-01-01 12:10</time_created>
<order_pos>1</order_pos>
<todo_list>108</todo_list>
<owner>
<id>326</id>
<name>Petrov Petr</name>
</owner>
<from>2012-03-03 16:00</from>
<to>2012-03-03 17:00</to>
</item>
</to-dos>
<comments>
<item>
<text>Текст комментария</text>
<text-html><p>Текст комментария в HTML</p></text-html>
<parent>
<id>1237</id>
<name>Текст родительского комментария</name>
</parent>
<time_created></time_created>
<work>1 час</work>
<work_date>2012-02-02</work_date>
</item>
</comments>
</data>
</response>