GET /api/collections/:id/edges — Связи коллекции
Сгенерировано из матриц + кода. Правки вносить в источники (
docs/matrices/,server/routes/), не здесь.
| Поле | Значение |
|---|---|
| HTTP | GET /api/collections/:id/edges |
| Auth | — |
| Scope токена | read |
| PG-функции | api.list_collection_edges |
| Таблицы | — |
| SRM | — (вне SRM, документировано по коду) |
| RP (права) | — |
| Файл роута | server/routes/collections.js |
| Статус | по коду (вне SRM) |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
аргументов не обнаружено (подтвердить вручную по server/routes/collections.js)
Коды ответов/ошибок (из хендлера): 200 — уточнить причины вручную
Для человека
Как открыть: «Коллекции» → откройте коллекцию → связи между блоками видны прямо на графе коллекции (стрелки от блока к блоку).
Возвращает список связей коллекции — стрелок между блоками. Каждая связь — это пара «откуда → куда»: один блок предшествует другому. На графе коллекции это рёбра, которые задают порядок этапов.
Кто может. Просмотреть коллекцию (а значит и её связи) может тот, у кого есть к ней доступ: сотрудник организации, администратор организации, администратор площадки. Точные правила доступа — на странице самой коллекции.
Для агента
Чтение — достаточно токена со scope read (см. Конвенции). Вызов идёт под ролью владельца токена: видны связи тех коллекций, к которым у него есть доступ.
Тела нет — коллекция адресуется в пути (:id). Ответ — массив рёбер, отсортированный по source_id, затем target_id.
Пример запроса:
curl https://specbuilder.vnimanie.ai/api/collections/0660b640-86b0-42c5-8e22-93973848bb56/edges \ -H "Authorization: Bearer tak_..."Ответ 200:
[ { "source_id": "business-goal", "target_id": "requirements" }, { "source_id": "requirements", "target_id": "data-model" }]Cookie-клиент получает JSON; Markdown-зеркало отдаётся только токену с Accept: text/markdown (server/agent/negotiate.js).