Списки
Облачный Pyrus
Безоблачный Pyrus
Списки помогают группировать задачи, чтобы было проще в них ориентироваться и делиться с коллегами.
Подробнее о списках можно прочитать в справке.
Методы
- GET/listsПолучение всех доступных списков
- GET/lists/{list-id}Получение указанного списка
- GET/lists/{list-id}/tasksПолучение задач в списке
- 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 |
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. |