API: Человеко-читаемые URL

API: Человеко-читаемые URL

Базовый путь: /api/v1/routes

Портал использует slug-пути в адресной строке (без hash и UUID):

Было	Стало
#/nodes/{uuid}	/portal
#/nodes/{uuid}/lists/{uuid}	/portal/lists/tasks
#/nodes/{uuid}/libraries/{uuid}	/portal/libraries/documents
#/nodes/{uuid}/pages/{uuid}	/portal/pages/welcome
#/groups	/groups

Вложенные узлы: /portal/hr/lists/zadachi (slug цепочкой от корня).

GET /routes/resolve?path=/portal/lists/tasks

Разобрать путь → IDs для роутера:

{
  "type": "list",
  "nodeId": "uuid",
  "listId": "uuid",
  "path": "/portal/lists/tasks"
}

Типы: home, node, list, library, page, groups, group.

GET /routes/canonical?type=list&nodeId=…&resourceId=…

Построить путь по ID (для ссылок и миграции меню):

{ "path": "/portal/lists/tasks", "type": "list", "nodeId": "...", "listId": "..." }

GET /routes/legacy?path=/nodes/{uuid}/lists/{uuid}

Конвертация старых hash-URL в canonical path (автоматически при первом входе).

Редактор меню

Указывайте пути вида /portal/lists/zadachi, а не #/nodes/uuid/....
Старые hash-ссылки в меню по-прежнему работают (редирект при клике).