POST /api/collections/:id/edges — Добавить связь
Как открыть: связи между блоками обычно расставляет генерация коллекции — отдельного жеста «протянуть стрелку» на графе коллекции нет, мышью блок только перемещается по холсту. Добавить связь вручную сейчас можно либо этим методом API, либо (для администратора площадки) формой «Добавить связь» с выпадающими списками «источник» и «получатель» в админ-панели.
Создаёт связь между двумя блоками коллекции — стрелку «откуда → куда»: один блок предшествует другому. Связать блок сам с собой нельзя (400). Повторное добавление той же пары дубль не создаёт и ошибки не вызывает.
Коллекция должна быть активной: добавить связь в коллекцию из корзины нельзя (404).
Кто может. Редактировать состав коллекции может администратор организации-владельца (и администратор площадки). Сотрудники и наблюдатели связи изменять не могут.
Связанные
Машинная сводка (HTTP, таблицы, связанные требования)
| Поле | Значение |
|---|---|
| HTTP | POST /api/collections/:id/edges |
| Auth | — |
| Scope токена | read_write |
| PG-функции | api.create_collection_edge |
| Таблицы | — |
| SRM | — (вне SRM, документировано по коду) |
| RP (права) | — |
| Файл роута | server/routes/collections.js |
| Статус | по коду (вне SRM) |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
| Аргумент | Где | Обяз. | Заметка |
|---|---|---|---|
source_id | body | подтвердить | |
target_id | body | подтвердить |
Коды ответов/ошибок (из хендлера): 201 (+ 200) — уточнить причины вручную