Таблица [app.groups.<path>] задаёт логическую структуру API и то, как функции будут разложены по generated package. Группы не выполняют запросы сами по себе, но определяют дерево классов и навигацию в клиенте.
| Ключ | Что делает | Как влияет на поведение |
|---|---|---|
description |
Описание группы | Используется в generated docs, docstring-ах и в IDE-подсказках. |
- Путь группы определяет, в каком namespace окажется функция.
- Группы строят дерево классов в generated client.
- Это удобно, когда API логически делится на каталоги, геолокацию, рекламу, общие хелперы и т.п.
[app.groups.Catalog]
description="Каталог и товарные методы"
[app.groups.Catalog.Products]
description="Методы страниц товара"
Для групп действуют общие правила identity путей и quoted/unquoted-имен. Если нужен разбор этих правил, см. Пути и identity.