POST /api/spaces/:id/layers/:layerId — Переопределить слой
Как открыть: верхняя панель → «Спейсы» → карточка спейса → вкладка «Слои». Дальше либо правьте поле у существующего слоя (рядом появится пометка «изменено»), либо нажмите «Добавить» — создаётся свой, кастомный слой.
Операция переопределения слоя поверх коллекции. Сама коллекция не меняется: правки складываются в оверлей спейса. Здесь у метода две роли:
- переопределить базовый слой — задать в этом спейсе своё отображаемое имя, цвет, позицию, порядок, описание или заголовок раздела документа (
doc_title), не трогая коллекцию. Переопределённое поле помечается «изменено» и в любой момент откатывается к исходному (снять переопределение); - добавить свой слой — если слоя с таким id в коллекции нет, заводится кастомный (
is_custom), живущий только в этом спейсе.
Заголовок раздела документа стоит пояснить отдельно: это то, как этап назовётся в готовом документе. Если поле пустое, берётся отображаемое имя слоя.
Не путайте с «вернуть исходное» (откат поля к коллекции) и «вернуть» (возврат ранее скрытого слоя).
Кто может. Менеджер своего спейса или администратор организации (RP-128 для переопределения, RP-134 для своего слоя). Сотрудник и наблюдатель оверлей не настраивают.
Связанные
Машинная сводка (HTTP, таблицы, связанные требования)
| Поле | Значение |
|---|---|
| HTTP | POST /api/spaces/:id/layers/:layerId |
| Auth | — |
| Scope токена | read_write |
| PG-функции | — |
| Таблицы | — |
| SRM | — (вне SRM, документировано по коду) |
| RP (права) | — |
| Файл роута | server/routes/spaces.js |
| Статус | по коду (вне SRM) |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
аргументов не обнаружено (подтвердить вручную по server/routes/spaces.js)
Коды ответов/ошибок (из хендлера): 200 — уточнить причины вручную