GET /api/collections/:id/access — Доступы организаций
Сгенерировано из матриц + кода. Правки вносить в источники (
docs/matrices/,server/routes/), не здесь.
| Поле | Значение |
|---|---|
| HTTP | GET /api/collections/:id/access |
| Auth | — |
| Scope токена | read |
| PG-функции | api.list_collection_org_access |
| Таблицы | — |
| SRM | — (вне SRM, документировано по коду) |
| RP (права) | — |
| Файл роута | server/routes/collections.js |
| Статус | по коду (вне SRM) |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
аргументов не обнаружено (подтвердить вручную по server/routes/collections.js)
Коды ответов/ошибок (из хендлера): 200 — уточнить причины вручную
Для человека
Как открыть: в обычном интерфейсе этой страницы нет — выдача доступа к коллекции между организациями относится к администрированию платформы. Список доступов запрашивает site-admin: это служебная сводка о том, каким организациям, помимо организации-владельца, открыта данная коллекция.
Возвращает перечень организаций, которым выдан доступ к коллекции (записи collection_org_access): по каждой — название, слаг и когда доступ был выдан. Если список пуст, у коллекции нет таких грантов и она видна только своей организации-владельцу (а также всем — если она публичная или доступна по умолчанию).
Важно про модель доступа: коллекция принадлежит ровно одной организации (owner_org_id), и её участники видят коллекцию автоматически — по членству в организации, без отдельной выдачи. Раздать коллекцию участникам своей организации нельзя «вручную» и не нужно. Этот список и сама выдача доступа — про межорганизационный случай, а его открывает только администратор платформы (см. Выдать доступ).
Для агента
Чтение — достаточно токена со scope read (см. Конвенции). Тела запроса нет, единственный параметр — :id коллекции в пути.
Пример запроса:
curl https://specbuilder.vnimanie.ai/api/collections/0660b640-86b0-42c5-8e22-93973848bb56/access \ -H "Authorization: Bearer tak_..."Ответ 200 — массив организаций, которым выдан доступ (по org_name):
[ { "org_id": "f9e8d7c6-...", "org_name": "Будущее", "org_slug": "buduschee", "granted_at": "2026-05-12T09:30:00Z" }]Пустой массив [] означает, что у коллекции нет межорганизационных грантов. Само добавление и снятие таких грантов токену недоступно ни на каком scope — это site-admin-операции (403): см. Выдать доступ и Отозвать доступ.