---
id: guide-guests
title: "Гостевой доступ"
kind: guide
---

# Гостевой доступ {#guide-guests}

Гость — это посетитель без входа в систему. Гостевой доступ — не отдельный набор
эндпоинтов, а **режим**: часть данных открыта на чтение по публичному срезу, а
share-ссылка даёт посмотреть конкретный проект. Ниже — две формы гостевого доступа
и методы, которыми они пользуются.

## Share-ссылка на проект

Владелец проекта может [создать share-ссылку](../domains/projects/api/share-project.md#projects-share-project) —
тогда по адресу с токеном проект открывается **только на чтение**, без входа
(`GET /api/projects/shared/:token`). Гость видит граф и описания блоков, но ничего
не меняет. Экран — «Shared view» с баннером «Общий доступ».

## Гостевой режим (публичные коллекции)

Если коллекция помечена как публичная, по ней автоматически создаётся гостевой спейс,
и посетитель без входа может собрать пробный проект. Такой режим включается заголовком
`X-Guest-Projects` (его проставляет фронтенд); гостю показывается баннер «Проекты не
сохраняются». Гостю доступны на чтение:

- [Доступные коллекции](../domains/collections/api/list-available.md#collections-list-available)
  (`GET /api/collections/available`) — из чего можно собрать проект.
- Публичные срезы спейса — например
  [публичные специальности](../domains/spaces/api/list-specialties-public.md#spaces-list-specialties-public)
  (`…/specialties/public`), а также `…/blocks/public`, `…/layers/public`,
  `…/edges/public` (см. домен [Спейсы](../domains/spaces/index.md#spaces-index)).
- Список проектов гостевого спейса (`GET /api/spaces/:spaceId/projects`,
  документирован по коду).

Собрать и сгенерировать пробный проект гость может теми же методами
[создать проект](../domains/projects/api/create-project.md#projects-create-project) и
[сгенерировать граф](../domains/projects/api/generate-graph.md#projects-generate-graph).
Результат сохраняется на сервере, но привязан к этому браузеру (список своих
гостевых проектов клиент передаёт заголовком `X-Guest-Projects`): смена браузера
или очистка его данных оборвёт доступ к гостевым проектам. При регистрации
гостевые проекты переезжают в личный спейс нового пользователя.

## Границы

Гость только читает открытое и собирает временный проект; никаких приватных данных,
управления и записи в чужие сущности ему недоступно. Подробнее о разграничении —
[роли](../shared/roles.md#roles) (роль «гость») и [Конвенции](../shared/conventions.md#conventions).
Источник истины по правам — матрица [RP](../../matrices/rp/).

---

Human view: https://docs.vnimanie.ai/specbuilder/v1/guides/guests/