library
Чтобы получить файлы PNG, SVG, GIF и JPG из стандартных или пользовательских библиотек, используйте метод file/library.
svc=file/library¶ms={"type":<text>,
"flags":<uint>}
Параметры
| Параметр | Описание |
|---|---|
| type | Имя библиотеки. Стандартные значения: unit, group, poi. |
| flags | Укажите одно из значений: 0 - получить список файлов только из стандартной библиотеки (допускаются только стандартные значения параметра type); 1 - рекурсивно получить список файлов из всех доступных библиотек иерархии (вашей учетной записи, родительской учетной записи, родительской учетной записи родительской и т. д.). |
Создание и поиск пользовательской библиотеки
Чтобы создать пользовательскую библиотеку, выполните следующие действия:
1. Создайте папку library в общедоступном файловом хранилище учетной записи: <account_id>/1/library
2. Поместите пользовательскую библиотеку в папку library. Например, если пользовательская библиотека называется cust_lib, путь к ней будет таким: <account_id>/1/library/cust_lib
Чтобы найти пользовательскую библиотеку и получить список ее содержимого, укажите имя библиотеки в качестве значения параметра type. Например, “type”:“cust_lib”
Ответ
В случае успешного выполнения запроса возвращается список файлов.
{
"<account_id>": [ /* ID учетной записи, 0 - стандартная библиотека */
{
"n":<text>, /* имя файла */
"s":<uint>, /* размер файла (в байтах) */
"ct":<uint>, /* время создания файла, UNIX-время */
"mt":<uint> /* время последнего изменения файла, UNIX-время */
},
...
],
... /* ID других учетных записей (если есть) */
}
Если указано “flags”:0, возвращается только массив файлов из стандартной библиотеки, без ID учетной записи.
В случае неудачного выполнения запроса возвращается код ошибки.
Коды ошибок
| Код | Описание |
|---|---|
| 1 | Пользователь не авторизован. |
| 4 | Некорректные входные параметры. |
| 5 | Не удалось получить список файлов из библиотеки и учетных записей. |
| 7 | Не удалось получить текущую учетную запись или элемент со стандартной библиотекой. |