Перейти к содержимому

Концепции

Корневая сущность изоляции. Каждый ключ привязан к одному Account, и все endpoint’ы автоматически фильтруются по нему - кросс-аккаунтный доступ невозможен.

Внутри аккаунта. Проекты могут вкладываться (parentProjectId) до 10 уровней. У задачи всегда есть projectId.

Основная рабочая сущность: title, description, status, priority, dueDate, assigneeId. Имеет Version (int) - используется в ETag/If-Match для оптимистической конкурентности на PATCH.

Account-level записи в календаре: startsAt, endsAt, allDay, location. В публичном API сейчас поддерживаются только одиночные события - серии и повторения пока недоступны.

Файл, привязанный к задаче. Загружается через multipart/form-data; max 100 MB; учитывается в storage-квоте аккаунта.

Строка вида tasks:read, tasks:write, projects:read, projects:write, events:read, events:write, attachments:read, attachments:write, account:read. Привязывается к ключу при создании и проверяется middleware’ом на каждый запрос.

Подписка (URL, секрет, eventTypes[]) на уровне аккаунта. Когда событие наступает, FlowWorker делает HTTP POST на ваш URL с HMAC-SHA256 подписью в заголовке X-FlowWorker-Signature.