1.1 查询文档上传地址
更新时间:2022-12-28
接口描述
获取文档上传信息地址, 通过返回地址执行上传文档操作
说明:doc_size参数需要和实际上传文档大小一致,文档上传到开发者账户下,以下操作接口同时支持普通类型文档上传操作
请求地址
https://ccapi.csslcloud.net/openapi/v1/doc/add
请求方式
GET
请求参数
接口统一权限认证请参考THQS认证方式。
名称 |
类型 |
必填 |
描述 |
accountId |
String |
是 |
开发者账号ID |
docName |
String |
是 |
文件名称,取值范围为:长度1~200个字符 |
docSize |
Integer |
是 |
文档大小,单位Byte,取值范围:1~500(MB) |
allow_animation |
Integer |
否 |
是否转换PPT动画:0为否,2为是,默认值:0,取值范围:[0,2] |
docType |
Integer |
否 |
文档类型:0为普通文档 ,1为铺码文档,默认值:0,取值范围:[0,1] |
cycleCode |
Integer |
否 |
循环铺码:0为非循环铺码,1为循环铺码。说明:1、如果cycleCode等于1时,铺码资源不够时将释放最早铺码的文件资源,释放后已下载铺码文件将不可用 2、当docType等于1的时候该值必须传值。默认值:0,取值范围:[0,1] |
返回数据
公共返回数据结构请参考 公共返回数据说明。
名称 |
类型 |
描述 |
uploadUrl |
String |
上传文档URL地址, |
返回示例
{
"result": "OK",
"error": null,
"data": {
"uploadUrl": "https://document.csslcloud.net/api/document/upload?userid=41E8063FC799ACE5&docid=36F5A35557149BF39C33DC5901307461&supportanimation=0"
},
"errorMsg": ""
}
1.2 文档上传
接口描述
通过上一步接口获取文档上传地址(data.upload_url)
文件格式支持:.doc .docx .ppt .pptx .pdf .png .jpg,铺码文档文件格式支持:.pdf大小仅支持A4
说明:Headers中需设置"Content-type"为"multipart/form-data"
请求地址
通过上一步接口获取文档上传地址(data.upload_url)
请求方式
POST
请求参数
名称 |
类型 |
必填 |
描述 |
file |
File |
是 |
文档二进制流 |
请求示例
POST https://document.csslcloud.net/api/document/upload?userid=83F203DAC2468694&docid=22736804D292F2559C33DC5901307461&supportanimation=0
Postman 请求示例:
返回数据
名称 |
类型 |
描述 |
success |
Boolean |
返回状态:true为成功,false为失败 |
errorCode |
Integer |
错误编码:1004为上传方式错误,一般为header头 Boundary设置问题 |
datas |
Object |
返回数据对象 |
datas说明
名称 |
类型 |
描述 |
docId |
String |
文档ID |
返回示例
{
"datas": {
"docId": "0A0833E541533352"
},
"errorCode": 0,
"success": true
}