POST /api/projects/:id/share — Создать share-ссылку
Как открыть: в списке проектов на карточке проекта откройте меню «⋯» и выберите «Поделиться». Скопируйте полученную публичную ссылку и отправьте её.
Создаёт публичную ссылку на проект — любой, у кого она есть, увидит проект в режиме только для чтения, без входа в систему. Менять проект через ссылку нельзя.
При желании укажите срок жизни ссылки в днях: по его истечении ссылка перестанет работать. Если срок не указан — ссылка бессрочная (пока её не отозвали).
Кто может. Поделиться проектом вправе владелец, менеджер спейса или администратор организации. Остальным действие недоступно (403). Точные правила — RP-156.
Связанные
- Экраны: Список проектов
- Конвенции · Роли · Ошибки · Глоссарий
Машинная сводка (HTTP, таблицы, связанные требования)
| Поле | Значение |
|---|---|
| HTTP | POST /api/projects/:id/share |
| Auth | requireAuth, requireProjectAccess — только авторизованный, доступ к проекту (read/write) |
| Scope токена | read_write |
| PG-функции | api.create_share_link |
| Таблицы | project_share, project |
| SRM | SRM-310 |
| RP (права) | — |
| Файл роута | server/routes/projects.js |
| Статус | done |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
| Аргумент | Где | Обяз. | Заметка |
|---|---|---|---|
expires | body | подтвердить |
Коды ответов/ошибок (из хендлера): 403 (+ 200) — уточнить причины вручную