Получить папку
Одна ветка дерева: сама папка и её подпапки со своим составом.
Запросить можно и подпапку – придёт она сама с пустым subfolders.
Параметры
folder_idчислообязательныйПапка, которую нужно получить.
Ответ
idчислоИдентификатор папки.
user_idчислоВладелец папки.
nameстрокаНазвание папки.
created_atдата и времяКогда папка создана.
parent_folder_idчисломожет быть пустымПапка-родитель. Пусто – папка лежит в корне.
groupsсписок объектовОбъекты, лежащие непосредственно в этой папке, без объектов подпапок.
groups[].idчислоИдентификатор объекта.
groups[].nameстрокаНазвание объекта.
subfoldersсписок объектовПодпапки этой папки, по названию по алфавиту.
subfolders[].idчислоИдентификатор подпапки.
subfolders[].user_idчислоВладелец подпапки.
subfolders[].nameстрокаНазвание подпапки.
subfolders[].created_atдата и времяКогда подпапка создана.
subfolders[].parent_folder_idчисломожет быть пустымПапка-родитель.
subfolders[].groupsсписок объектовОбъекты, лежащие непосредственно в подпапке.
subfolders[].groups[].idчислоИдентификатор объекта.
subfolders[].groups[].nameстрокаНазвание объекта.
subfolders[].subfoldersсписок объектовВсегда пусто: глубина ограничена двумя уровнями.
subfolders[].subfolders[].idчислоИдентификатор папки. Обычное целое число — папки не участвуют в кодировании идентификаторов.
subfolders[].subfolders[].user_idчислоИдентификатор владельца папки. Он же её создатель: папка всегда создаётся себе — POST /v2/folders не принимает чужого владельца.
subfolders[].subfolders[].nameстрокаНазвание папки.
subfolders[].subfolders[].created_atдата и времяМомент создания папки (UTC, ISO 8601).
subfolders[].subfolders[].parent_folder_idчисломожет быть пустымИдентификатор родительской папки. null — папка корневая. Глубина ограничена двумя уровнями: папка → подпапка → группы, поэтому у подпапки подпапок быть не может.
subfolders[].subfolders[].groupsсписок объектовГруппы, лежащие непосредственно в этой папке (без групп подпапок). Приходят объектами с названиями, чтобы не ходить за ними в GET /v2/groups; на вход POST/PATCH принимают массив идентификаторов group_ids. Здесь виден состав, а не то, что попадёт в выдачу: выключенная (is_active=false) группа остаётся в составе, но отзывов и аналитики по folder_id не даёт — то же правило, что и в списке групп. Удалённая группа из состава пропадает.
subfolders[].subfolders[].groups[].idчислоИдентификатор группы.
subfolders[].subfolders[].groups[].nameстрокаНазвание группы.
subfolders[].subfolders[].subfoldersсписок объектовПодпапки этой папки — каждая со своим составом. Порядок тот же, что у папок верхнего уровня: по названию, при совпадении — по id. Глубина ограничена двумя уровнями, поэтому у подпапки здесь всегда пустой список. У подпапки есть и свои группы, и они не смешиваются с группами родителя: groups каждой папки — только её собственный состав. В выдачу по folder_id (отзывы, аналитика) попадают группы папки и её подпапок.
subfolders[].subfolders[].subfolders[].idчислоИдентификатор папки. Обычное целое число — папки не участвуют в кодировании идентификаторов.
subfolders[].subfolders[].subfolders[].user_idчислоИдентификатор владельца папки. Он же её создатель: папка всегда создаётся себе — POST /v2/folders не принимает чужого владельца.
subfolders[].subfolders[].subfolders[].nameстрокаНазвание папки.
subfolders[].subfolders[].subfolders[].created_atдата и времяМомент создания папки (UTC, ISO 8601).
subfolders[].subfolders[].subfolders[].parent_folder_idчисломожет быть пустымИдентификатор родительской папки. null — папка корневая. Глубина ограничена двумя уровнями: папка → подпапка → группы, поэтому у подпапки подпапок быть не может.
subfolders[].subfolders[].subfolders[].groupsсписок объектовГруппы, лежащие непосредственно в этой папке (без групп подпапок). Приходят объектами с названиями, чтобы не ходить за ними в GET /v2/groups; на вход POST/PATCH принимают массив идентификаторов group_ids. Здесь виден состав, а не то, что попадёт в выдачу: выключенная (is_active=false) группа остаётся в составе, но отзывов и аналитики по folder_id не даёт — то же правило, что и в списке групп. Удалённая группа из состава пропадает.
subfolders[].subfolders[].subfolders[].subfoldersсписок объектовПодпапки этой папки — каждая со своим составом. Порядок тот же, что у папок верхнего уровня: по названию, при совпадении — по id. Глубина ограничена двумя уровнями, поэтому у подпапки здесь всегда пустой список. У подпапки есть и свои группы, и они не смешиваются с группами родителя: groups каждой папки — только её собственный состав. В выдачу по folder_id (отзывы, аналитика) попадают группы папки и её подпапок.
curl -X GET "https://example.com/v2/folders/0"{ "id": 12, "user_id": 6, "name": "Москва", "created_at": "2026-07-28T16:50:24", "parent_folder_id": null, "groups": [ { "id": 20, "name": "Националь" }, { "id": 21, "name": "Метрополь" } ], "subfolders": [ { "id": 13, "user_id": 6, "name": "Центр", "created_at": "2026-07-28T16:52:11", "parent_folder_id": 12, "groups": [ { "id": 22, "name": "Балчуг" } ], "subfolders": [] } ]}Коды ошибок общие для всего API и описаны на странице Ошибки.