POST /api/collections/:id/specialties — Добавить специальность
Как открыть: «Коллекции» → откройте коллекцию → в редакторе коллекции в левой панели специальностей нажмите «Добавить специальность».
Создаёт новую специальность (роль) в коллекции: имя, описание и цвета, которыми подсвечиваются её ноды и облако на графе. У специальности есть ключ (id) — он задаётся при создании и больше не меняется; в редакторе видны и надпись, и ключ.
Цвет (color) обязателен. Светлый фон и цвет рамки можно не задавать — тогда они останутся пустыми. Порядок в списке регулируется числом сортировки.
Коллекция должна быть активной: добавить специальность в коллекцию из корзины нельзя (404).
Кто может. Редактировать состав коллекции может администратор организации-владельца (и администратор площадки). Сотрудник и наблюдатель содержимое коллекции не меняют.
Связанные
Машинная сводка (HTTP, таблицы, связанные требования)
| Поле | Значение |
|---|---|
| HTTP | POST /api/collections/:id/specialties |
| Auth | — |
| Scope токена | read_write |
| PG-функции | api.upsert_collection_specialty |
| Таблицы | — |
| SRM | — (вне SRM, документировано по коду) |
| RP (права) | — |
| Файл роута | server/routes/collections.js |
| Статус | по коду (вне SRM) |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
| Аргумент | Где | Обяз. | Заметка |
|---|---|---|---|
border | body | подтвердить | |
color | body | подтвердить | |
description | body | подтвердить | |
id | body | подтвердить | |
light | body | подтвердить | |
name | body | подтвердить | |
sort_order | body | подтвердить |
Коды ответов/ошибок (из хендлера): 201 (+ 200) — уточнить причины вручную