导入文件

适用版本>=v7.0.2512.20251225

接口说明：导入文件

请求说明

请求地址	配置域名+/openapi+/v7/appfiles/drives/{drive_id}/files/{parent_id}/import
请求方法	POST
签名方式	KSO-1（配置域名+/openapi不参与签名）
权限要求	应用身份管理文档（应用授权） kso.appfiles.import.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
parent_id	string	是	父目录id

查询参数（Query）

字段名	类型	必填	说明
name	string	是	文件名称
format	string	是	目标文件格式,目前只支持visio转pom(流程图)和xmind、excel转pof(思维导图)
size	int64	是	文件大小（字节）
_w_third_user_id	string	否	操作者id

请求体（Body）

字段名	类型	必填	说明
file	file	是	上传的文件内容

响应体（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	创建时间（Unix 时间戳）
∟ mtime	integer	修改时间（Unix 时间戳）
∟ shared	boolean	是否开启分享（应用文档为 false）
∟ link_id	string	链接 ID（应用文档为空字符串）
∟ link_url	string	链接 URL（应用文档为空字符串）
∟ created_by	object	创建者信息
∟∟ id	string	身份 ID
∟∟ type	string	Enum: "sp"
∟ modified_by	object	修改者信息
∟∟ id	string	身份 ID
∟∟ type	string	Enum: "sp"
code	int	错误码
msg	string	状态信息
detail	string	详细信息

响应体示例

{
    "data": {
        "id": "350745587089408",
        "drive_id": "349087249465344",
        "parent_id": "0",
        "created_by": {
            "id": "userId",
            "type": "sp"
        },
        "modified_by": {
            "id": "userId",
            "type": "sp"
        },
        "size": 14498,
        "version": 1,
        "type": "file",
        "name": "文件导入.pom",
        "ctime": 1764928529,
        "mtime": 1764928529,
        "shared": false,
        "link_url": "",
        "link_id": ""
    },
    "code": 0,
    "detail": "",
    "msg": "ok"
}