GET /api/spaces/:id/blocks/public — Публичные блоки спейса
Сгенерировано из матриц + кода. Правки вносить в источники (
docs/matrices/,server/routes/), не здесь.
| Поле | Значение |
|---|---|
| HTTP | GET /api/spaces/:id/blocks/public |
| Auth | — |
| Scope токена | read |
| PG-функции | — |
| Таблицы | — |
| SRM | — (вне SRM, документировано по коду) |
| RP (права) | — |
| Файл роута | server/routes/spaces.js |
| Статус | по коду (вне SRM) |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
аргументов не обнаружено (подтвердить вручную по server/routes/spaces.js)
Коды ответов/ошибок (из хендлера): 200 — уточнить причины вручную
Для человека
Как открыть: отдельного экрана у этого среза нет — он работает «под капотом». Когда гость без входа выбирает на экране создания публичную коллекцию и запускает генерацию, фронтенд этим запросом подтягивает блоки именно той коллекции, чтобы граф нарисовался её слоями, а не остатками прошлого проекта.
Это публичный, гостевой вариант списка блоков спейса: то же содержимое, что у списка блоков, но без входа. Открыт только для гостевых спейсов — на любой другой тип спейса (личный, командный) эндпоинт отвечает 403, даже без сессии. Приватные поля в этом срезе не отдаются.
Кто может. Любой, без авторизации, но исключительно для спейса типа guest (RP-136). Для своих и командных спейсов авторизованный пользователь читает обычный список блоков.
Для агента
Чтение без авторизации: эндпоинт не требует ни cookie, ни токена. Под токеном тоже вызывается — agent-gate просто снимает заголовок X-Guest-Projects (агент не гость), но GET к /api/spaces/... остаётся в read-allowlist (server/auth/agentGate.js), так что read-токену срез доступен.
Путь-параметр — :id (id спейса). Жёсткое условие в коде: SELECT type FROM space должен вернуть guest, иначе — 403 { "error": "Только гостевые спейсы" }. Тела у запроса нет.
Пример запроса:
curl https://specbuilder.vnimanie.ai/api/spaces/{id}/blocks/publicОтвет 200 — JSON-массив блоков (та же форма, что у списка блоков). Только JSON: ни Markdown-зеркала, ни ## Actions, ни ETag/304 у публичного среза нет.