文件内容操作

适用版本>=v7.0.2512.20251225

接口说明：文件内容操作

请求说明

请求地址	配置域名+/openapi+/v7/appfiles/drives/{drive_id}/files/{file_id}/content/operate
请求方法	POST
签名方式	KSO-1（配置域名+/openapi不参与签名）
权限要求	应用身份管理文档（应用授权） kso.appfiles.cps.readwrite

请求头（Header）

Header	参数类型	是否必填	说明
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
file_id	string	是	文件id

查询参数（Query）

名称	类型	是否必填	说明
_w_third_user_id	string	否	操作者id

请求体（Body）

字段名	类型	必填	说明
dst_drive_id	string	否	目标驱动盘 ID
dst_parent_id	string	否	目标父目录 ID
steps	[]object	是	操作步骤列表，每个步骤包含具体操作信息
∟ operate	string	是	操作类型，可选值：OFFICE_CLEAN - 清稿
∟ args	object	否	操作参数，可选
∟∟ clean_options	[]string	否	清稿可选项： • accept_all_revisions - 指定接受所有修订 • delete_all_comments - 删除所有批注 • delete_all_ink - 删除所有墨迹 默认所有参数都会生效：accept_all_revisions,delete_all_comments,delete_all_ink

请求体示例

{
  "dst_drive_id": "1234567890",
  "dst_parent_id": "0",
  "steps": [
    {
      "operate": "OFFICE_CLEAN",
      "args": {
        "clean_options": [
          "accept_all_revisions"
        ]
      }
    }
  ]
}

响应体（Response）

名称	类型	说明
data	object	返回的数据对象
∟ id	string	文件 ID
∟ name	string	文件名称
∟ type	string	文件类型，Enum: "folder" "file"
∟ parent_id	string	父目录 ID（例如 "0"）
∟ size	integer	文件大小（字节）
∟ version	integer	文件版本号
∟ drive_id	string	驱动盘 ID
∟ ctime	integer	创建时间
∟ mtime	integer	修改时间
∟ shared	boolean	是否开启分享（应用文档为 false）
∟ link_id	string	链接 ID（应用文档为空字符串）
∟ link_url	string	链接 URL（应用文档为空字符串）
∟ created_by	object	创建者信息
∟∟ id	string	身份 ID
∟∟ type	string	Enum: "user" "sp"
∟ modified_by	object	修改者信息
∟∟ id	string	身份 ID
∟∟ type	string	Enum: "user" "sp"
code	int	错误码
msg	string	状态信息
detail	string	详细信息

响应体示例

{
    "data": {
        "id": "350747753447424",
        "drive_id": "349087249465344",
        "parent_id": "0",
        "created_by": {
            "id": "userId",
            "type": "sp"
        },
        "modified_by": {
            "id": "userId",
            "type": "sp"
        },
        "size": 11055,
        "version": 1,
        "type": "file",
        "name": "应用文档测试文件.docx",
        "ctime": 1764929562,
        "mtime": 1764929562,
        "shared": false,
        "link_url": "",
        "link_id": ""
    },
    "code": 0,
    "detail": "",
    "msg": "ok"
}