1.1 获取文档上传地址
更新时间：2022-12-28
接口描述
获取文档上传信息地址, 通过返回地址执行上传文档操作
说明：doc_size参数需要和实际上传文档大小一致
请求地址
https://ccapi.csslcloud.net/api/v1/doc/add
请求方式
GET
请求参数
接口统一权限认证请参考THQS认证方式。
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| account_id | String | 是 | 开发者账号ID |
| doc_name | String | 是 | 文档名称，取值范围为：长度1~200个字符 |
| doc_size | String | 是 | 文档大小，单位Byte,取值范围：1~500(MB) |
| allow_animation | Integer | 否 | 是否转换PPT动画：0为否，2为是，默认值：0，取值范围：[0,2] |
| room_id | String | 否 | 直播间ID，传入后会将文档直接关联直播间下，此方式适用于客户不能接收文档回调场景， 说明：建议上传完成收到文档处理完成回调之后使用文档关联接口进行关联 |
请求示例
GET https://ccapi.csslcloud.net/api/v1/doc/add?account_id=41E8063FC799ACE&room_id=D90DCF5BF6DA3C8C9C33DC5901307461&doc_name=xxx.jpg&doc_size=111time=1670412086&hash={hash}
返回数据
公共返回数据结构请参考 公共返回数据说明。
| 名称 | 类型 | 描述 |
|---|---|---|
| upload_url | String | 上传地址Url，使用该url进行下一步真实文件上传 |
返回示例
{
"data": {
"upload_url": "https://document.csslcloud.net/api/document/upload?userid=41E8063FC799ACE5&docid=06EDECC84FB4F764"
},
"result": "OK"
}
1.2 文档上传
更新时间：2022-12-28
接口描述
通过上一步接口获取文档上传地址（data.upload_url）
文件格式支持：.doc .docx .ppt .pptx .pdf .png .jpg
说明：Headers中需设置"Content-type"为"multipart/form-data"
请求地址
通过上一步接口获取文档上传地址（data.upload_url）
请求方式
POST
请求参数
接口统一权限认证请参考THQS认证方式。
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| 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 | Array | 上传生成的文档信息 |
datas说明
| 名称 | 类型 | 描述 |
|---|---|---|
| docId | String | 文档ID |
返回示例
{
"datas": {
"docId": "0A0833E541533352"
},
"errorCode": 0,
"success": true
}
