Список папок

Всё дерево папок одним запросом: в data – корневые папки, подпапки лежат внутри своего родителя.

Состав у каждой папки свой: объекты подпапки не входят в состав родителя, хотя в выдачу по его folder_id попадают.

Ответ

dataсписок объектов

Корневые папки, по названию по алфавиту. Пагинации нет.

data[].idчисло

Идентификатор папки.

data[].user_idчисло

Владелец папки.

data[].nameстрока

Название папки.

data[].created_atдата и время

Когда папка создана.

data[].parent_folder_idчисломожет быть пустым

Папка-родитель. Пусто – папка лежит в корне.

data[].objectsсписок объектов

Объекты, лежащие непосредственно в этой папке, без объектов подпапок.

data[].objects[].idчисло

Идентификатор объекта.

data[].objects[].nameстрока

Название объекта.

data[].subfoldersсписок объектов

Подпапки этой папки, по названию по алфавиту.

data[].subfolders[].idчисло

Идентификатор подпапки.

data[].subfolders[].user_idчисло

Владелец подпапки.

data[].subfolders[].nameстрока

Название подпапки.

data[].subfolders[].created_atдата и время

Когда подпапка создана.

data[].subfolders[].parent_folder_idчисломожет быть пустым

Папка-родитель.

data[].subfolders[].objectsсписок объектов

Объекты, лежащие непосредственно в подпапке.

data[].subfolders[].objects[].idчисло

Идентификатор объекта.

data[].subfolders[].objects[].nameстрока

Название объекта.

data[].subfolders[].subfoldersсписок объектов

Всегда пусто: глубина ограничена двумя уровнями.

data[].subfolders[].subfolders[].idчисло

Идентификатор папки.

data[].subfolders[].subfolders[].user_idчисло

Владелец папки.

data[].subfolders[].subfolders[].nameстрока

Название папки.

data[].subfolders[].subfolders[].created_atдата и время

Момент создания папки (UTC, ISO 8601).

data[].subfolders[].subfolders[].parent_folder_idчисломожет быть пустым

Родительская папка; null у папки верхнего уровня.

data[].subfolders[].subfolders[].objectsсписок объектов

Собственный состав папки — объекты с названиями.

data[].subfolders[].subfolders[].subfoldersсписок объектов

Подпапки со своим составом.

curl -X GET "https://example.com/v3/folders"

{  "data": [    {      "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 и описаны на странице Ошибки.