GET /api/orgs/:orgId — Организация
Как открыть: в переключателе активной организации на верхней панели выберите нужную организацию и перейдите на вкладку «Организация» — откроется экран организации с её карточкой.
Возвращает карточку одной организации: название, слаг, список участников (с их ролями и e-mail) и командные спейсы организации. Это основа экрана организации — заголовок, список людей и навигация по спейсам.
Видеть карточку может только участник этой организации. Запрос к организации, в которой вы не состоите, возвращает 403 — ровно как если бы её не существовало, чтобы по коду ответа нельзя было выяснить чужой состав. Просмотр карточки не требует прав администратора: участнику она доступна на чтение, а управлять (приглашать, менять роли, удалять) может только администратор организации.
Связанные
- Экраны: Организация
- Конвенции · Роли · Ошибки · Глоссарий
Машинная сводка (HTTP, таблицы, связанные требования)
| Поле | Значение |
|---|---|
| HTTP | GET /api/orgs/:orgId |
| Auth | — |
| Scope токена | read |
| PG-функции | api.get_org_details |
| Таблицы | organization, org_member |
| SRM | SRM-058 |
| RP (права) | RP-060, RP-066 |
| Файл роута | server/routes/orgs.js |
| Статус | done |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
аргументов не обнаружено (подтвердить вручную по server/routes/orgs.js)
Коды ответов/ошибок (из хендлера): 404 (+ 200) — уточнить причины вручную