API-пайплайн: всё, чем вы владеете и что вам доступно (Кабинет)

Индекс: API-пайплайны — индекс

Цель: получить список всего, чем вы владеете, и всего, чем поделились с вами, по типам.

Шаги

1. Чем вы владеете, по типам.

GET /v0/my/projects?limit=20&offset=0
→ {"projects": [{"card_type": "project", "nonce": "470000000000000001", "title": "…", "visibility": "Private", …}], "total": 3}

То же для articles, posts, docs, sheets, boards, workspaces, campaigns, telegram_groups (ключ groups), oracles, agendas, api_endpoints, secrets, links, rubrics, coupons. Большинство принимают scope=owned|granted|all (по умолчанию owned) и archived=true (только архивные карточки).

2. Всё, чем поделились с вами.

GET /v0/graph/my/granted
→ {"granted": [{"tile": {"card_type": "workspace", "nonce": "…", "title": "…", …},
                "rights": {"read": true, "write": false, "execute": false},
                "via": [{"nonce": "<link>", "title": "…", "expires_at": "…"}]}],
   "total": 4}

rights = что вам разрешено; via = ссылки доступа, через которые пришёл доступ, и когда он заканчивается.

3. Свои и доступные вместе, по заголовку. GET /v0/accessible/cards?type=project&type=workspace&q=trip → элементы с source: "owned" | "granted" и вашими permissions; листайте по next_cursor. Подробности: API-пайплайн: поиск по графу

4. Как связаны ваши карточки. GET /v0/graph/my/edges?kind=containment&target_nonce=<card> → в каких ваших рабочих пространствах лежит карточка. Все виды связей и фильтры: API-пайплайн: связать две карточки отношением, раздел «Другие связи ваших карточек».

Что происходит за кадром

• Архивные карточки не попадают в списки, если не запросить archived=true: API-пайплайн: архивировать, вернуть или удалить свои карточки
• Ваши лайки: API-пайплайн: лайкать карточки и находить их снова. Ваши рабочие пространства: API-пайплайн: собирать карточки в рабочие пространства.

Правила

• 401 без токена. edges: 400 без source_nonce или target_nonce либо с неизвестным kind.

Поверхность API