library

Чтобы получить файлы PNG, SVG, GIF и JPG из стандартных или пользовательских библиотек, используйте метод file/library.

Copied!

svc=file/library&params={
    "type":<text>,
    "flags":<uint>
    }

Параметры

Параметр	Описание
type	Имя библиотеки. По умолчанию используются следующие значения: unit, group, poi.
flags	Укажите одно из значений: 0 - перечислить файлы из стандартной библиотеки (допускаются только значения параметра type по умолчанию); 1 - рекурсивно перечислить файлы из всех доступных библиотек иерархии (ваша учетная запись, родительская, родительская родительской и т. д.).

Параметр

Описание

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’

Возвращаемый результат

При успешном выполнении запроса возвращается список файлов.

Copied!

{
  "<account_id>": [           /* ID учетной записи, 0 — стандартная библиотека */
    {
      "n": <text>,            /* имя файла */
      "s": <uint>,            /* размер файла в байтах */
      "ct": <uint>,           /* время создания файла, UNIX-время */
      "mt": <uint>            /* время последнего изменения файла, UNIX-время */
    },
    ...
  ],
  ...                         /* ID других учётных записей (если применимо) */
}

Если запрос не выполнен, возвращается код ошибки:

Коды ошибок

Код	Описание
1	Пользователь не авторизован.
4	Невалидные входные параметры.
5	Не удалось извлечь список файлов из библиотеки и учетных записей.
7	Не удалось извлечь учетную запись или элемент со стандартной библиотекой.