File API

文件API端点

获取Avatar仓库中的文件

get

https://files.pysio.onlinehttps://www.pysio.onlinehttps://pysio.onlinehttp://localhost:8080

/Avatar/{path}

直接获取Avatar仓库中的文件内容

Path parameters

pathstringRequired

文件路径

Responses

200

成功获取文件内容

*/*

string · binaryOptional

404

文件不存在

get

/Avatar/{path}

HTTPcURLJavaScriptPython

GET /Avatar/{path} HTTP/1.1
Host: files.pysio.online
Accept: */*

binary

获取Pysio-FontAwesome仓库中的文件

get

https://files.pysio.onlinehttps://www.pysio.onlinehttps://pysio.onlinehttp://localhost:8080

/Pysio-FontAwesome/{path}

直接获取Pysio-FontAwesome仓库中的文件内容

Path parameters

pathstringRequired

文件路径

Responses

200

成功获取文件内容

*/*

string · binaryOptional

404

文件不存在

get

/Pysio-FontAwesome/{path}

HTTPcURLJavaScriptPython

GET /Pysio-FontAwesome/{path} HTTP/1.1
Host: files.pysio.online
Accept: */*

binary

获取所有仓库的同步状态

get

https://files.pysio.onlinehttps://www.pysio.onlinehttps://pysio.onlinehttp://localhost:8080

/api/files/sync/status

返回所有配置的Git仓库的同步状态信息

Responses

200

成功获取同步状态

application/json

codeintegerOptionalExample: 200

messagestringOptionalExample: success

405

方法不允许

application/json

get

/api/files/sync/status

HTTPcURLJavaScriptPython

GET /api/files/sync/status HTTP/1.1
Host: files.pysio.online
Accept: */*

{
  "code": 200,
  "message": "success",
  "data": {
    "repo1": {
      "lastSync": "2023-01-01T12:00:00Z",
      "nextSync": "2023-01-01T13:00:00Z",
      "progress": 75.5,
      "totalFiles": 100,
      "currentFiles": 75,
      "status": "syncing",
      "error": ""
    }
  }
}

获取指定路径下的文件列表

get

https://files.pysio.onlinehttps://www.pysio.onlinehttps://pysio.onlinehttp://localhost:8080

/api/files/{path}

返回指定路径下的文件和目录列表，支持分页

Path parameters

pathstringRequired

文件路径

Query parameters

pageintegerOptional

页码，默认为1

Default: 1

pageSizeinteger · max: 100Optional

每页大小，默认为20，最大为100

Default: 20

Responses

200

成功获取文件列表

application/json

codeintegerOptionalExample: 200

messagestringOptionalExample: success

500

服务器错误

application/json

get

/api/files/{path}

HTTPcURLJavaScriptPython

GET /api/files/{path} HTTP/1.1
Host: files.pysio.online
Accept: */*

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "name": "example.jpg",
      "path": "images/example.jpg",
      "size": 1024,
      "lastModified": "2023-01-01T12:00:00Z",
      "isDirectory": false,
      "url": "https://files.pysio.online/images/example.jpg"
    }
  ],
  "pagination": {
    "current": 1,
    "pageSize": 20,
    "total": 100
  }
}

获取Images存储桶中的文件

get

https://files.pysio.onlinehttps://www.pysio.onlinehttps://pysio.onlinehttp://localhost:8080

/Images/{path}

直接获取Images存储桶中的文件内容

Path parameters

pathstringRequired

文件路径

Responses

200

成功获取文件内容

*/*

string · binaryOptional

404

文件不存在

get

/Images/{path}

HTTPcURLJavaScriptPython

GET /Images/{path} HTTP/1.1
Host: files.pysio.online
Accept: */*

binary

获取状态摘要

get

https://files.pysio.onlinehttps://www.pysio.onlinehttps://pysio.onlinehttp://localhost:8080

/status/summary.json

获取从外部URL同步的状态摘要信息

Responses

200

成功获取状态摘要

application/json

objectOptional

404

文件不存在

get

/status/summary.json

HTTPcURLJavaScriptPython

GET /status/summary.json HTTP/1.1
Host: files.pysio.online
Accept: */*

{}

获取指定桶中的文件信息

patch

https://files.pysio.onlinehttps://www.pysio.onlinehttps://pysio.onlinehttp://localhost:8080

/{bucket}/{path}

获取指定存储桶中的文件信息

Path parameters

bucketstringRequired

存储桶名称

pathstringRequired

文件路径

Body

application/json

bucketstringRequired

存储桶名称

Example: Images

pathstringRequired

文件路径

Example: example.jpg

Responses

200

成功获取文件信息

application/json

codeintegerOptionalExample: 200

messagestringOptionalExample: success

400

无效的请求格式

application/json

403

存储桶为只读

application/json

404

文件或存储桶不存在

application/json

patch

/{bucket}/{path}

HTTPcURLJavaScriptPython

PATCH /{bucket}/{path} HTTP/1.1
Host: files.pysio.online
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "bucket": "Images",
  "path": "example.jpg"
}

{
  "code": 200,
  "message": "success",
  "data": {
    "name": "example.jpg",
    "path": "images/example.jpg",
    "size": 1024,
    "lastModified": "2023-01-01T12:00:00Z",
    "isDirectory": false,
    "url": "https://files.pysio.online/images/example.jpg"
  }
}

获取文件内容

get

https://files.pysio.onlinehttps://www.pysio.onlinehttps://pysio.onlinehttp://localhost:8080

/{path}

直接获取文件内容，支持从配置的仓库或暴露路径访问

Path parameters

pathstringRequired

文件路径

Responses

200

成功获取文件内容

*/*

string · binaryOptional

302

重定向到文件的公共URL

403

未授权的访问路径

404

文件不存在

get

/{path}

HTTPcURLJavaScriptPython

GET /{path} HTTP/1.1
Host: files.pysio.online
Accept: */*

binary