Списки
Облачный Pyrus
Безоблачный Pyrus
Списки помогают группировать задачи, чтобы было проще в них ориентироваться и делиться с коллегами.
Подробнее о списках можно прочитать в справке.
Методы
- GET/
listsПолучение всех доступных списков - GET/
lists/ {list-id}Получение указанного списка - GET/
lists/ {list-id}/ tasksПолучение задач в списке - POST/
lists/ {list-id}Изменение списка - GET/
inboxПолучение задач во входящих
GET /lists
Метод возвращает все доступные пользователю списки.
GET https://api.pyrus.com/v4 /lists
Тело ответа
{
"lists": [
{
"id": 1352,
"name": "Branch offices",
"children": [
{
"id": 1465,
"name": "Moscow"
},
{
"id": 3763,
"name": "San Francisco"
}
]
},
{
"id": 2144,
"name": "Personal"
}
]
}
curl
curl -X GET \ https://api.pyrus.com/v4/lists \ -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \ -H 'Content-Type: application/json'
GET /lists/{list-id}
Метод возвращает указанный список.
GET https://api.pyrus.com/v4 /lists /1352 ?item_count=100
Тело ответа
{
"id": 1352,
"name": "Branch offices",
"children": [
{
"id": 1465,
"name": "Moscow"
},
{
"id": 3763,
"name": "San Francisco"
}
]
}
curl
curl -X GET \ https://api.pyrus.com/v4/lists/1352 \ -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \ -H 'Content-Type: application/json'
GET /lists/{list-id}/tasks
Метод возвращает все задачи в списке.
GET https://api.pyrus.com/v4 /lists /2144 /tasks ?item_count=100 &include_archived=y &modified_before=2022-04-21T15:51:27z &modified_after=2022-03-11T15:51:25Z
Тело ответа
{
"tasks": [
{
"id": 7991,
"create_date": "2018-02-28T07:34:23Z",
"last_modified_date": "2018-02-28T07:34:23Z",
"author": {
"id": 1731,
"first_name": "Bob",
"last_name": "Smith",
"email": "Bob.Smith@gmail.com",
"type": "user"
},
"responsible": {
"id": 1731,
"first_name": "Bob",
"last_name": "Smith",
"email": "Bob.Smith@gmail.com",
"type": "user"
},
"text": "Prepare Presentation",
"due_date": "2022-04-13"
},
{
"id": 7992,
"create_date": "2018-02-27T17:42:42Z",
"last_modified_date": "2018-02-27T17:42:42Z",
"author": {
"id": 1731,
"first_name": "Bob",
"last_name": "Smith",
"email": "Bob.Smith@gmail.com",
"type": "user"
},
"responsible": {
"id": 1731,
"first_name": "Bob",
"last_name": "Smith",
"email": "Bob.Smith@gmail.com",
"type": "user"
},
"text": "Order office supplies"
}
],
"has_more": false
}
curl
curl -X GET \ https://api.pyrus.com/v4/lists/2144/tasks ?item_count=100 &include_archived=y &modified_before=2022-04-21T15:51:27Z &modified_after=2022-03-11T15:51:25Z\ -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \ -H 'Content-Type: application/json'
Параметры
| item_count | Максимальное количество задач в ответе, по умолчанию 200. |
| include_archived | Укажите "y", если хотите включить в результат архивные задачи. |
| modified_before | Задачи, измененные до указанной даты по UTC (включительно).Формат: YYYY-MM-DDThh:mm:ssZ |
| modified_after | Задачи, измененные после указанной даты по UTC (включительно).Формат: YYYY-MM-DDThh:mm:ssZ |
POST /lists/{list-id}
Метод изменяет метаданные списка — название и состав участников и администраторов.
POST https://api.pyrus.com/v4 /lists /43082
Тело запроса
{
"removed_managers": [],
"removed_members": [],
"added_managers": [18498],
"added_members": [1733]
}
Тело ответа
{
"id": 43082,
"name": "api spisok",
"version": 90090,
"list_type": "private",
"color": "#4CAF50",
"member_ids": [
1733
],
"manager_ids": [
1731,
18498
]
}
curl
curl -X POST \ https://api.pyrus.com/v4/lists/43082 \ -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \ -H 'Content-Type: application/json'
Параметры
| removed_managers | массив идентификаторов пользователей, удаление администраторов списка. |
| removed_removed_members | массив идентификаторов пользователей, удаление участников списка. |
| added_managers | массив идентификаторов пользователей, добавление администраторов списка. |
| added_members | массив идентификаторов пользователей, добавление участников списка. |
GET /inbox
Метод возвращает все задачи в папке Входящие, в том числе задачи, объединенные группы.
GET https://api.pyrus.com/v4 /inbox ?item_count=100 &group_item_count=50
Тело ответа
{
"tasks": [
{
"id": 7991,
"create_date": "2018-02-28T07:34:23Z",
"last_modified_date": "2018-02-28T07:34:23Z",
"author": {
"id": 1731,
"first_name": "Bob",
"last_name": "Smith",
"email": "Bob.Smith@gmail.com",
"type": "user"
},
"responsible": {
"id": 1731,
"first_name": "Bob",
"last_name": "Smith",
"email": "Bob.Smith@gmail.com",
"type": "user"
},
"text": "Prepare Presentation",
"due_date": "2022-04-13"
},
{
"id": 7992,
"create_date": "2018-02-27T17:42:42Z",
"last_modified_date": "2018-02-27T17:42:42Z",
"author": {
"id": 1731,
"first_name": "Bob",
"last_name": "Smith",
"email": "Bob.Smith@gmail.com",
"type": "user"
},
"responsible": {
"id": 1731,
"first_name": "Bob",
"last_name": "Smith",
"email": "Bob.Smith@gmail.com",
"type": "user"
},
"text": "Order office supplies"
}
],
"has_more": false,
"task_groups": [
{
"id": 10,
"name": "group",
"has_more": false,
"tasks": [
{
"id": 9991,
"create_date": "2018-02-28T07:34:23Z",
"last_modified_date": "2018-02-28T07:34:23Z",
"author": {
"id": 1731,
"first_name": "Bob",
"last_name": "Smith",
"email": "Bob.Smith@gmail.com",
"type": "user"
}
}
]
}
]
}
curl
curl -X GET \ https://api.pyrus.com/v4/inbox ?item_count=100&group_item_count=50 \ -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \ -H 'Content-Type: application/json'
Параметры
| item_count | Максимальное количество задач в ответе, по умолчанию 50. |
| group_item_count | Максимальное число задач в одной группе в ответе, по умолчанию 50. |