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

Scopes

Scope - это строка вида <resource>:<action>, которая определяет какие операции разрешены ключу. Назначаются при создании, проверяются на каждый запрос.

ScopeОписание
account:readЧтение информации об аккаунте (GET /me) и участников аккаунта (GET /members, GET /members/{userId}).
projects:readЧтение проектов (GET /projects, GET /projects/{id}).
projects:writeСоздание/изменение проектов.
tasks:readЧтение задач (GET /tasks, GET /tasks/{id}).
tasks:writeСоздание, обновление, удаление задач.
events:readЧтение событий календаря (GET /events, GET /events/{id}).
events:writeСоздание, обновление, удаление событий.
attachments:readЧтение метаданных и скачивание вложений.
attachments:writeЗагрузка и удаление вложений.

При отсутствии требуемого scope сервер возвращает 403 Forbidden с телом:

{
"error": {
"code": "insufficient_scope",
"message": "Required scope 'tasks:write' is missing"
}
}

Заголовок WWW-Authenticate содержит требуемый scope:

WWW-Authenticate: Bearer error="insufficient_scope", scope="tasks:write"

Каждое OAuth-приложение имеет поле rateLimitPerMinute (диапазон 1..500, default 500). Это третий бакет в dual-bucket модели (per-key + per-account + per-oauth-app). При превышении любого бакета сервер возвращает 429 Too Many Requests.

PATCH /api/v1/accounts/{accountId}/oauth-apps/{clientId}
{
"rateLimitPerMinute": 100
}

Приложение автоматически отключается (isDisabled=true) после 100 подряд ответов 429 от бэкенда. Для ручного восстановления:

PATCH /api/v1/accounts/{accountId}/oauth-apps/{clientId}
{
"isDisabled": false
}

Выдавайте только те scopes, которые действительно нужны интеграции. Например, для бота, который читает задачи и комментирует - достаточно tasks:read; не давайте tasks:write, если код не пишет.