GET /api/spaces/:spaceId/specialties — Специальности спейса
Как открыть: вкладка «Спейсы» в шапке → карточка нужного спейса → «Настройки спейса» → раздел «Специализации». Таблица в этом разделе и есть результат метода.
Возвращает специальности (роли-специализации) спейса — это оверлей поверх базовых специальностей коллекции. То, что вы видите в таблице, складывается из трёх слоёв: унаследованные специальности коллекции как есть; те же специальности, но с переопределёнными в спейсе полями (цвет, название, описание); и кастомные специальности, добавленные только в этом спейсе. Удалённые в спейсе унаследованные специальности из выдачи исчезают (их можно вернуть через Вернуть специальность).
По каждой строке приходит то, что нужно для отрисовки: ключ специальности, отображаемое имя, цвета (основной, светлый, рамка), описание, порядок сортировки и пометки — кастомная ли это строка и какие поля переопределены. Те, у кого есть переопределение, в интерфейсе помечаются индикатором и кнопкой «Вернуть исходное значение».
Кто может. Видит специальности любой, у кого есть доступ к спейсу: участник, менеджер спейса (спейсмен), наблюдатель, администратор организации. Менять — только спейсмен своего спейса или org_admin (см. Переопределить). Для гостевого спейса есть отдельный публичный срез — Публичные специальности.
Связанные
Машинная сводка (HTTP, таблицы, связанные требования)
| Поле | Значение |
|---|---|
| HTTP | GET /api/spaces/:spaceId/specialties |
| Auth | requireSpaceAccess — requireSpaceAccess |
| Scope токена | read |
| PG-функции | api.list_space_specialties |
| Таблицы | space_specialty, space_specialty_overlay |
| SRM | SRM-160 |
| RP (права) | RP-053 |
| Файл роута | server/routes/spaces.js |
| Статус | done |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
| Аргумент | Где | Обяз. | Заметка |
|---|---|---|---|
border | body | подтвердить | |
color | body | подтвердить | |
description | body | подтвердить | |
enabled | body | подтвердить | |
is_custom | body | подтвердить | |
light | body | подтвердить | |
name | body | подтвердить | |
sort_order | body | подтвердить |
Коды ответов/ошибок (из хендлера): 200 — уточнить причины вручную