Основы API
Методы API

Список напоминаний

GET/tasks
tasks:read

Метод для получения списка напоминаний.

Параметры строки запроса

limit
integer, (int32)
Количество возвращаемых сущностей за один запрос
Пример:1
По умолчанию:
50
Диапазон:
1 — 50
cursor
string
Курсор для пагинации (из meta.paginate.next_page)
Пример:eyJpZCI6MTAsImRpciI6ImFzYyJ9

Ответ

200OK
The request has succeeded.
data[]
array of objects
*
id
integer, (int32)
*
Идентификатор напоминания
Пример:22283
kind
string
*
Тип
Возможные значения
Пример:reminder
content
string
*
Описание
Пример:Забрать со склада 21 заказ
due_at
nullablestring, (date-time)
*
Срок выполнения напоминания (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ
Пример:2020-06-05T09:00:00.000Z
priority
integer, (int32)
*
Приоритет
Пример:2
user_id
integer, (int32)
*
Идентификатор пользователя-создателя напоминания
Пример:12
chat_id
nullableinteger, (int32)
*
Идентификатор чата, к которому привязано напоминание
Пример:334
status
string
*
Статус напоминания
Возможные значения
Пример:undone
created_at
string, (date-time)
*
Дата и время создания напоминания (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ
Пример:2020-06-04T10:37:57.000Z
performer_ids[]
array of integers, (int32)
*
Массив идентификаторов пользователей, привязанных к напоминанию как «ответственные»
Пример:[12]
all_day
boolean
*
Напоминание на весь день (без указания времени)
Пример:false
custom_properties[]
array of objects
*
Дополнительные поля напоминания
id
integer, (int32)
*
Идентификатор поля
Пример:1678
name
string
*
Название поля
Пример:Город
data_type
string
*
Тип поля
Возможные значения
Пример:string
value
string
*
Значение
Пример:Санкт-Петербург
meta
object
Метаданные пагинации
paginate
object
Вспомогательная информация
next_page
string
Курсор пагинации следующей страницы
Пример:eyJxZCO2MiwiZGlyIjomSNYjIn3
Список напоминаний
# Для получения следующей страницы используйте cursor из meta.paginate.next_pagecurl "https://api.pachca.com/api/shared/v1/tasks?limit=1" \  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Ответ 200
{  "data": [    {      "id": 22283,      "kind": "reminder",      "content": "Забрать со склада 21 заказ",      "due_at": "2020-06-05T09:00:00.000Z",      "priority": 2,      "user_id": 12,      "chat_id": 334,      "status": "undone",      "created_at": "2020-06-04T10:37:57.000Z",      "performer_ids": [        12      ],      "all_day": false,      "custom_properties": [        {          "id": 1678,          "name": "Город",          "data_type": "string",          "value": "Санкт-Петербург"        }      ]    }  ],  "meta": {    "paginate": {      "next_page": "eyJxZCO2MiwiZGlyIjomSNYjIn3"    }  }}