预导入文档

openID

60

接口说明

本接口用于创建导入信息。导入文档步骤详见导入文档步骤。

调用方拿到返回的腾讯云上传链接相关信息后，调用接口执行文档上传动作。

权限说明

本接口需要拥有以下任意一项权限：

• scope.drive.creatable

请求格式

描述	定义
Path	/openapi/drive/v2/files/upload
Method	POST
Content-Type	application/x-www-form-urlencoded
Accept	application/json

请求头部

详见Headers。

请求参数

路径参数

无

查询参数

无

请求体

参数名	类型	必选	描述
fileMD5	string	是	文件的 MD5 值
fileName	string	是	文件名，支持的文件名后缀：xls,xlsx,csv,doc,docx,txt,text,ppt,pptx,pdf,xmind,pos
fileSize	integer	是	文件大小，单位为字节
uploadType	string	否	上传类型，drive:上传到云端存储，默认表示上传为在线文档

响应参数

请求体

参数名	类型	描述
ret	integer	业务返回码
msg	string	业务返回码描述
data	json object	业务响应数据，详见COS 文件信息

请求包体

POST /openapi/drive/v2/files/upload HTTP/1.1
Host: docs.qq.com
Access-Token: ACCESS_TOKEN
Client-Id: CLIENT_ID
Open-Id: OPEN_ID
Content-Type: application/x-www-form-urlencoded
Content-Length: 52

fileMD5=FILE_MD5&fileName=example.pdf&fileSize=55000

示例

curl --location --request POST 'https://docs.qq.com/openapi/drive/v2/files/upload' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID' \
--header 'Open-Id: OPEN_ID' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'fileMD5=FILE_MD5' \
--data-urlencode 'fileName=example.pdf' \
--data-urlencode 'fileSize=55000'

响应包体

HTTP/1.1 200 OK
Date: Thu, 28 Jul 2022 15:34:46 GMT
Content-Type: text/plain; charset=utf-8
Content-Length: 3
Connection: keep-alive
 
{
    "ret": 0,
    "msg": "Succeed",
    "data": {
        "COSPutURL": "https://xxxx.cos.ap-guangzhou.myqcloud.com/xxxxx",
        "COSFileKey": "temp/u144115223409310760/import_587dd76f58feebf510b6170b07894183.pdf",
        "CustomHeader": {
            "Content-Type": "application/pdf",
            "x-cos-acl": "default"
        }
    }
}

错误码

错误码	错误说明	排查建议
10313	Access-Token 为空	HTTP Header 里 Access-Token 校验失败，请参考示例中的携带方式，检查相应字段。详情请见Headers。
10303	Open-Id 错误	HTTP Header 里 Open-Id 与预期不符，可能的原因有： - Open-Id 为空。请参考示例中的携带方式，检查相应字段。详情请见Headers。 - Open-Id 与 Access-Token 不匹配，请检查 Header 内容和获取 Token 接口回包是否一致。
10302	Client-Id 错误	HTTP Header 里 Client-Id 与预期不符，可能的原因有： - Client-Id 为空。请参考示例中的携带方式，检查相应字段。详情请见Headers。 - Client-Id 与 Access-Token 不匹配，请检查 Header 内容和调用获取 Token 接口接口时参数中的 Client-Id 是否一致。
37019	Token 校验失败，错误或过期	检查位于 HTTP Header 中的 Access-Token 是否正确，获取 Token 的方式请查阅授权流程以及获取 Token 接口

查询更多业务返回码