Содержание

Увидеть содержимое каталога
- Параметры
- Возвращаемый результат

Увидеть содержимое каталога

Вы можете получить структуру папки файлового хранилища с помощью команды file/list:

svc=file/list&params={"itemId":<long>,
		      "storageType":<uint>,
		      "path":<text>,
   		      "mask":<text>,
	   	      "recursive":<bool>,
		      "fullPath":<bool>}

Параметры

Параметр	Описание
itemId	id элемента
storageType	тип хранилища: 1 - public (видеть/скачивать могут все), 2 - protected (видят/скачивают те, кому выданы права)
path	относительный путь из корневой папки
mask	фильтр имён; можно использовать '*': она может заменить 0, 1, …, множество символов
recursive	флаг, показывать ли содержимое папок рекурсивно
fullPath	флаг, показывать ли полные пути для каждого элемента

Лишь у создателя элемента есть права выкладывать и удалять контент.

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

'n/c'-сигнатура означает, что элемент иерархии является каталогом, 'n/s'-сигнатура – что является файлом.

[
	{
		"n": <text>,		/* путь до выбранной папки */
		"c": [			/* содержимое корневого каталога, внутри могут быть файлы и/или папки */
				{	
					"n": <text> 	/* имя каталога */
					"c": [...]	/* содержимое каталога, внутри могут быть файлы и/или папки */
				},
 
				{
					"n": <text>, 	/* имя файла */
					"s": <text> 	/* размер файла (байты) */
				},
				...
		]
	},
	...,				/* другие папки */
	{
		"n": <text>, 	/* имя файла, находящегося в руте хранилища */
		"s": <text> 	/* размер файла (байты) */
	},
	...				/* другие файлы */		
]

Если путь не существует, то:

{
    "error": 5
}