list
Чтобы увидеть структуру хранилища, используйте метод file/list.
svc=file/list¶ms={
"itemId":<long>,
"storageType":<uint>,
"path":<text>,
"mask":<text>,
"recursive":<bool>,
"fullPath":<bool>
}
Параметры
Параметр | Описание |
---|---|
itemId | ID элемента. |
storageType | Тип хранилища: |
path | Относительный путь от корневой папки к файлу. |
mask | Маска имени файла. Она может содержать звездочку (*), которая заменяет 0 или более символов, и вопросительный знак (?), который заменяет 1 символ. Если вы указываете несколько масок, используйте запятую в качестве разделителя. |
recursive | Используйте этот флаг, чтобы указать, должно ли содержимое отображаться рекурсивно со вложенными папками. |
fullPath | Используйте этот флаг, чтобы указать, должен ли показываться полный путь к элементам. |
Только создатель элемента может размещать и удалять файлы.
Возвращаемый результат
При успешном выполнении запроса возвращается структура хранилища. Сигнатура n/c означает, что элемент иерархии — папка, сигнатура n/s — файл.
[
{
"n": <text>, /* путь к указанной папке, начинается с «public» или «protected» */
"c": [ /* содержимое корневой папки, может включать файлы и/или вложенные папки */
{
"n": <text>, /* имя папки */
"c": [ ... ] /* содержимое папки, может включать файлы и/или вложенные папки */
},
{
"n": <text>, /* имя файла */
"s": <text> /* размер файла (байт) */
}
// ...
]
}
]
Если запрос выполнить не удалось, возвращается код ошибки.
Коды ошибок
Код | Описание |
---|---|
1 | Пользователь не авторизован. |
4 | Пользователь не авторизован. |
5 | Не удалось получить список файлов по указанному пути. |
7 | IНедостаточно прав на элемент, указанный в параметре itemId. |