文件秒传

适用版本>=v7.0.2507.20250724

接口说明：文件秒传

标签：文件

请求说明

字段	值
请求地址	配置域名+/openapi+/v7/drives/{drive_id}/files/{parent_id}/rapid_upload
HTTP 方法	POST
接口描述	文件秒传，不保证上传后的文件秒传一定能命中
签名方式	KSO-1（配置域名+/openapi不参与签名）
限频策略	无
权限要求	查询和管理文件(应用授权) kso.file.readwrite 查询和管理文件(用户授权) kso.file.readwrite

请求头 (Headers)

属性名	类型	是否必填	描述	可选值
X-Kso-Id-Type	string	否	类型 * internal - 内部 * external - 外部	internal, external
X-Kso-Date	string	是	RFC1123 格式的日期，例: Wed, 23 Jan 2013 06:43:08 GMT	-
X-Kso-Authorization	string	是	KSO-1 签名值，详见《签名方法》	-
Authorization	string	是	授权凭证，格式为：Bearer {access_token}	-

路径参数 (Path)

属性名	类型	是否必填	描述	可选值
drive_id	string	是	驱动盘id	-
parent_id	string	是	文件夹id（根目录时为0）	-

请求体(Body)

请求体格式: application/json

没有可用的数据

请求体示例

{
  "hashes": [
    {
      "sum": "string",
      "type": "s2s"
    }
  ],
  "name": "string",
  "on_name_conflict": "string",
  "on_parent_path_conflict": "string",
  "parent_path": [
    "string"
  ],
  "size": 0
}

响应体(Response)

HTTP状态码: 200
响应体格式: application/json

没有可用的数据

响应体示例

{
  "data": {
    "created_by": {
      "avatar": "string",
      "company_id": "string",
      "id": "string",
      "name": "string",
      "type": "string"
    },
    "ctime": 0,
    "drive": {
      "allotee_id": "string",
      "allotee_type": "string",
      "bucket": "string",
      "company_id": "string",
      "created_by": {
        "avatar": "string",
        "company_id": "string",
        "id": "string",
        "name": "string",
        "type": "string"
      },
      "ctime": 0,
      "description": "string",
      "ext_attrs": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "id": "string",
      "mtime": 0,
      "name": "string",
      "quota": {
        "deleted": 0,
        "remaining": 0,
        "total": 0,
        "used": 0
      },
      "source": "string",
      "status": "string"
    },
    "drive_id": "string",
    "ext_attrs": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "hash": {
      "sum": "string",
      "type": "s2s"
    },
    "id": "string",
    "link_id": "string",
    "link_url": "string",
    "modified_by": {
      "avatar": "string",
      "company_id": "string",
      "id": "string",
      "name": "string",
      "type": "string"
    },
    "mtime": 0,
    "name": "string",
    "parent_id": "string",
    "permission": {
      "comment": true,
      "copy": true,
      "copy_content": true,
      "delete": true,
      "download": true,
      "list": true,
      "move": true,
      "new_empty": true,
      "perm_ctl": true,
      "preview": true,
      "print": true,
      "rename": true,
      "share": true,
      "update": true,
      "upload": true
    },
    "size": 0,
    "type": "string",
    "version": 0
  },
  "code": 0,
  "msg": "string"
}