列出文件夹（目录）

  • 请求地址 /v1/files/page POST
  • 请求方式 JSON/Http POST
  • 请求参数
Properties Type Description
* parent string 该文件夹的ID(可选)
* path string 路径(可选)
* page int 第几页
* pageSize int 列表大小
* orderBy int 排序 0按 文件名 1 按时间
* type int 文件类型 0 显示文件 1 显示文件夹 -1 显示文件和文件夹(默认)

1.请求的时候，如果 name 和 path均为空，则会返回根目录 2.pageSize最大值为999，大于999将只返回999条记录

  • 排序
  • 0 文件夹排在前面， 创建时间倒序， 文件名正序 （典型：按创建时间倒序、按文件夹正序）
  • 1 文件夹排在前面， 文件名正序，创建时间正序
  • 2 文件夹排在前面， 文件名倒序，创建时间正序
  • 3 文件夹排在前面， 文件名倒序，创建时间倒序 （典型：按文件名倒序）
  • 4 文件夹排在前面， 文件名正序，创建时间正序 （典型：按文件名正序）
  • 8 文件夹排在前面， 创建时间正序，文件名正序 （典型：按创建时间正序）
  • 9 文件夹排在前面， 创建时间正序，文件名倒序
  • 10 文件夹排在前面， 创建时间倒序，文件名倒序
  • 11 文件夹排在前面， 创建时间正序，文件名正序
  • 14 文件排在前面，创建时间倒序，文件名正序 （典型：文件名正序）

文件Metadata

文件夹 Meta信息如下：

Properties Type Description
uuid string 该文件/文件夹的唯一ID
name string 文件名
mime string 文件mime，即文件的类型
type int 0:为文件,1:目录
parent string 父目录id
ctime long 文件创建时间
mtime string 文件修改时间
atime string 文件访问时间
userId long 用户id
path string 该文件或文件夹的访问路径
ext string 后缀
size long 文件大小(字节)
flag int 总是 0
preview int 预览状态
recycle int 0:正常文件，1:回收站

示例

  • 列出根目录

发送 /v1/files/page :

  1. {
  2. }

收到:

  1. {
  2.     "status": 200,
  3.     "result": {
  4.         "page": 1,
  5.         "pageSize": 20,
  6.         "totalCount": 5,
  7.         "totalPage": 1,
  8.         "list": [
  9.             {
  10.                 "uuid": "4a394153a3284b57ab32dd19057bf4c8",
  11.                 "storeId": "",
  12.                 "userId": 5,
  13.                 "path": "/123",
  14.                 "name": "123",
  15.                 "ext": "",
  16.                 "size": 0,
  17.                 "parent": "e724aaabf0c544bba3aef642455d104e",
  18.                 "type": 1,
  19.                 "atime": 1532601197732,
  20.                 "ctime": 1532601197732,
  21.                 "mtime": 0,
  22.                 "version": 0,
  23.                 "locking": false,
  24.                 "mime": "application/x-directory",
  25.                 "preview": -1,
  26.                 "flag": 0
  27.             },
  28.             {
  29.                 "uuid": "9ad4d23682714ad2a5168ad91a6e93b5",
  30.                 "storeId": "",
  31.                 "userId": 5,
  32.                 "path": "/456",
  33.                 "name": "456",
  34.                 "ext": "",
  35.                 "size": 0,
  36.                 "parent": "e724aaabf0c544bba3aef642455d104e",
  37.                 "type": 1,
  38.                 "atime": 1532601218238,
  39.                 "ctime": 1532601218238,
  40.                 "mtime": 0,
  41.                 "version": 0,
  42.                 "locking": false,
  43.                 "mime": "application/x-directory",
  44.                 "preview": -1,
  45.                 "flag": 0
  46.             },
  47.             {
  48.                 "uuid": "08b1fe17a2164f4a851f45c4cc984109",
  49.                 "storeId": "",
  50.                 "userId": 5,
  51.                 "path": "/11133",
  52.                 "name": "11133",
  53.                 "ext": "",
  54.                 "size": 0,
  55.                 "parent": "e724aaabf0c544bba3aef642455d104e",
  56.                 "type": 1,
  57.                 "atime": 1532603220059,
  58.                 "ctime": 1532603220059,
  59.                 "mtime": 0,
  60.                 "version": 0,
  61.                 "locking": false,
  62.                 "mime": "application/x-directory",
  63.                 "preview": -1,
  64.                 "flag": 0
  65.             },
  66.             {
  67.                 "uuid": "65ae1e0df8ea45d6abafbeff21f504c4",
  68.                 "storeId": "",
  69.                 "userId": 5,
  70.                 "path": "/null",
  71.                 "name": "null",
  72.                 "ext": "",
  73.                 "size": 0,
  74.                 "parent": "e724aaabf0c544bba3aef642455d104e",
  75.                 "type": 1,
  76.                 "atime": 1532762745920,
  77.                 "ctime": 1532762745920,
  78.                 "mtime": 0,
  79.                 "version": 0,
  80.                 "locking": false,
  81.                 "mime": "application/x-directory",
  82.                 "preview": -1,
  83.                 "flag": 0
  84.             },
  85.             {
  86.                 "uuid": "311951072e804c179c234a3e054de51b",
  87.                 "storeId": "",
  88.                 "userId": 5,
  89.                 "path": "/d",
  90.                 "name": "d",
  91.                 "ext": "",
  92.                 "size": 0,
  93.                 "parent": "e724aaabf0c544bba3aef642455d104e",
  94.                 "type": 1,
  95.                 "atime": 1532780479835,
  96.                 "ctime": 1532780479835,
  97.                 "mtime": 0,
  98.                 "version": 0,
  99.                 "locking": false,
  100.                 "mime": "application/x-directory",
  101.                 "preview": -1,
  102.                 "flag": 0
  103.             }
  104.         ],
  105.         "info": {
  106.             "uuid": "e724aaabf0c544bba3aef642455d104e",
  107.             "storeId": "",
  108.             "userId": 5,
  109.             "path": "/",
  110.             "name": "",
  111.             "ext": "",
  112.             "size": 0,
  113.             "parent": "",
  114.             "type": 1,
  115.             "atime": 1532601155841,
  116.             "ctime": 1532601155841,
  117.             "mtime": 1532601155841,
  118.             "version": 0,
  119.             "locking": false
  120.         }
  121.     }
  122.     "code": "OK",
  123.     "success": true,
  124.     "token": "..."
  125. }
  • 使用path列出文件夹(推荐)

发送 /v1/files/page :

  1. {
  2.     "path":"/f@ck/de/de/d/ede/d/xe/de/w/x/e/r/fr/f/rcm"
  3. }

收到:

  1. {
  2.     "status": 200,
  3.     "result": {
  4.         "page": 1,
  5.         "pageSize": 20,
  6.         "totalCount": 3,
  7.         "totalPage": 1,
  8.         "path": [
  9.             {
  10.                 "uuid": "528",
  11.                 "storeId": "",
  12.                 "userId": 11,
  13.                 "path": "/f@ck/de/de/d/ede/d/xe/de/w/x/e/r/fr/f/rcm/jka",
  14.                 "size": 0,
  15.                 "parent": "524",
  16.                 "mime": "application/x-directory",
  17.                 "type": 1,
  18.                 "atime": 1522074711237,
  19.                 "mtime": 1522074711237,
  20.                 "ctime": 1522074711237,
  21.                 "alias": "",
  22.                 "from": 0,
  23.                 "name": "jka",
  24.                 "ext": "",
  25.                 "preview": 0,
  26.                 "flag": 0,
  27.                 "recycle": 0
  28.             },
  29.             {
  30.                 "uuid": "527",
  31.                 "storeId": "",
  32.                 "userId": 11,
  33.                 "pathId": "bda8a307284501d3b03458820b8631ec",
  34.                 "path": "/f@ck/de/de/d/ede/d/xe/de/w/x/e/r/fr/f/rcm/中文路径",
  35.                 "size": 0,
  36.                 "parent": "524",
  37.                 "mime": "application/x-directory",
  38.                 "type": 1,
  39.                 "atime": 1522036499927,
  40.                 "mtime": 1522036499927,
  41.                 "ctime": 1522036499927,
  42.                 "alias": "",
  43.                 "from": 0,
  44.                 "name": "中文路径",
  45.                 "ext": "",
  46.                 "preview": 0,
  47.                 "flag": 0,
  48.                 "recycle": 0
  49.             },
  50.             {
  51.                 "uuid": "526",
  52.                 "storeId": "",
  53.                 "userId": 11,
  54.                 "pathId": "5086788dcfe9a204c78608e11144c611",
  55.                 "path": "/f@ck/de/de/d/ede/d/xe/de/w/x/e/r/fr/f/rcm/papaya",
  56.                 "size": 0,
  57.                 "parent": "524",
  58.                 "mime": "application/x-directory",
  59.                 "type": 1,
  60.                 "atime": 1522036319687,
  61.                 "mtime": 1522036319687,
  62.                 "ctime": 1522036319687,
  63.                 "alias": "",
  64.                 "from": 0,
  65.                 "name": "papaya",
  66.                 "ext": "",
  67.                 "preview": 0,
  68.                 "flag": 0,
  69.                 "recycle": 0
  70.             }
  71.         ],
  72.         "info": {
  73.             "uuid": "524",
  74.             "storeId": "",
  75.             "userId": 11,
  76.             "pathId": "d284c0c2825d280545a9b29f5d8c84d2",
  77.             "path": "/f@ck/de/de/d/ede/d/xe/de/w/x/e/r/fr/f/rcm",
  78.             "size": 0,
  79.             "parent": "523",
  80.             "mime": "application/x-directory",
  81.             "type": 1,
  82.             "atime": 1522036319294,
  83.             "mtime": 1522036319294,
  84.             "ctime": 1521995361898,
  85.             "alias": "",
  86.             "from": 0,
  87.             "name": "rcm",
  88.             "ext": "",
  89.             "preview": 0,
  90.             "flag": 0,
  91.             "recycle": 0
  92.         }
  93.     },
  94.     "code": "OK",
  95.     "success": true,
  96.     "token": "..."
  97. }