OpenList Multipart Upload API
    • Init multipart upload
      POST
    • Upload one chunk
      PUT
    • Complete multipart upload
      POST
    • Query upload session
      GET
    • Abort multipart upload
      POST

      Query upload session

      GET
      /api/fs/multipart/status
      Two valid parameter combinations: pass upload_id alone, or pass path and size together to discover a resumable live session of the current user (e.g. after a page refresh, or to poll the verdict when complete was cut off by a CDN). Each parameter is optional on its own, but one of the two combinations is required.

      请求参数

      Authorization
      JWT Bearer
      在 Header 添加参数
      Authorization
      示例:
      Authorization: ********************
      or
      Query 参数

      请求示例代码

      Shell
      JavaScript
      Java
      Swift
      Go
      PHP
      Python
      HTTP
      C
      C#
      Objective-C
      Ruby
      OCaml
      Dart
      R
      请求示例请求示例
      Shell
      JavaScript
      Java
      Swift
      curl --location '/api/fs/multipart/status?upload_id=&path=&size=' \
      --header 'Authorization: Bearer <token>'

      返回响应

      🟢200Success
      application/json
      Session found; data is the latest session snapshot
      Bodyapplication/json

      示例
      {
          "code": 200,
          "message": "success",
          "data": {
              "upload_id": "3f2c9e2a-6c4b-4d2e-9a2b-1f0e8c7d5a41",
              "state": "receiving",
              "attempt": 0,
              "path": "/uploads/movie.mkv",
              "size": 734003200,
              "chunk_size": 10485760,
              "total_chunks": 70,
              "received": [
                  [
                      0,
                      8
                  ],
                  [
                      10,
                      11
                  ]
              ],
              "received_bytes": 115343360,
              "frontier": 9,
              "storage_progress": 12.86
          }
      }
      🟠400Bad Query
      🟠401Unauthorized
      🟠403Forbidden
      🟠404Session Not Found
      修改于 2026-07-13 17:33:15
      上一页
      Complete multipart upload
      下一页
      Abort multipart upload
      Built with