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