文档库相关接口

日期: 2021-03-02

创盛视联数码科技（北京）有限公司

[TOC]

一、流程说明

文档上传实际上到账户下面，要在房间内使用，需要调用关联/取消关联接口 进行操作

二、相关接口

1.上传文档

描述：

创建文档信息并获取上传信息, 通过返回上传信息，执行上传文档操作

注意，第一步doc_size参数需要和第二步实际上传文档大小一致

1.1 获取文档上传信息

地址：

https://ccapi.csslcloud.net/api/v1/doc/add

方法：

POST/GET

请求参数：

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
doc_name 字符串 文件名 必须
doc_size 整型 文档大小，单位Byte（最大不能超过104857600 必须
allow_animation 整型 是否极速文档 默认为0， 0不支持 1支持ppt 2ppt极速
room_id 字符串 房间id 选填，传入后会将文档直接关联房间下 (建议上传完成收到文档转码回调完成之后，使用文档关联接口进行关联,此方式适用于客户不能提供文档相关回调对接接口场景)

返回示例:

{
  "data": {
    "upload_url": "https://document.csslcloud.net/api/document/upload?userid=41E8063FC799ACE5&docid=06EDECC84FB4F764"
  },
  "result": "OK"
}
1.2 文档上传

地址：

 上传地址通过 上一步 获取文档信息接口 返回（data.upload_url）
 文件格式支持:  .doc  .docx  .ppt  .pptx  .pdf  .png
 后续支持jpg

方法：

POST

请求参数：

参数名称 参数类型 参数说明 备注
file 二进制 文档 必须
supportanimation 整型 支持动画，0:不支持 1:支持 （只对PPT有效） 可选

备注:

file需要放到request body里面，supportanimation参数需要拼接到URL中, 如果需要

返回示例:

{
    "datas": {
        "docId": "0A0833E541533352"
    },
    "errorCode": 0,
    "success": true
}

2.删除账户共享文件

描述：

实际删除账户下的共享文档

地址：

https://ccapi.csslcloud.net/api/v1/doc/delete

方法：

POST/GET

请求参数：

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
doc_id 字符串 文档ID 必须

返回示例:

{
    "result": "OK", # 失败： FAIL，成功：OK
}

3.获取账户共享文档列表

描述：

获取某个账户下共享文档列表

地址：

https://ccapi.csslcloud.net/api/v1/doc/list

方法：

POST/GET

请求参数:

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
page 整型 获取指定页，默认返回第一页 可选
lines 整型 每页的数据条数，默认每页50 可选
room_id 整型 查询该账户下的文档 是否与该房间已关联 可选
doc_id 整型 文档ID, 用于查询 可选
doc_name 字符串 文档名, 用于查询 可选
time_gte 日期 date/datetime 根据此参数，选择上传时间>= 该值的文档 可选
time_lte 日期 date/datetime 根据此参数，选择上传时间<= 该值的文档 可选

返回示例:

{
    "result": "OK",
    "picDomain": "https://image.csslcloud.net", # 实际去访问文档的地址
    "docs": [
        {
            "id": "CFD3C4FB8D2B6148", # 文件ID
            "name": "MBA讲座.ppt", # 文件名称
            "pageSize": 24, # 文件页数
            "roomId": "2EE731074C8D64679C33DC5901307461", # 共享盘房间ID
            "size": 3679232 # 文件大小
            "useSDK": 0 # ppt动效 0: 未开启  1: 开启
            "create_time": "2018-01-01 12:00:00" # 上传时间
            "status": 1 # -2: 未上传  -1:上传失败 0: 上传成功 1: 转换成功 2: 转换中 3: 转换失败
            "related": 1 #  1: 已关联 0 未关联，如果room_id参数没传，则不返回该字段
        }

    ],
    "total": 1,  # 总页数
    "current": 1 # 当前页数
}

4.获取房间文档列表

描述：

获取用户房间关联文档详情列表

地址:

https://ccapi.csslcloud.net/api/v1/doc/auth/list

方法:

POST/GET

请求参数:

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
room_id 字符串 房间ID 必须
page 整型 获取指定页，默认返回第一页 可选
lines 整型 每页的数据条数，默认每页50 可选
doc_id 字符串 文件ID 用于查询 可选
doc_name 字符串 文件名 用于查询 可选

返回示例:

{
    "result": "OK",
    "picDomain": "https://image.csslcloud.net", # 实际去访问文档的地址
    "docs": [
        {
        "id": "CFD3C4FB8D2B6148", # 文件ID
        "name": "MBA讲座.ppt", # 文件名称
        "pageSize": 24, # 文件页数
        "roomId": "2EE731074C8D64679C33DC5901307461", # 共享盘房间ID
        "size": 3679232 # 文件大小
        "useSDK": 0 # ppt动效 0: 未开启  1: 开启
        "create_time": "2018-01-01 12:00:00" # 上传时间
        "status": 1 # 文档状态  0 上传成功 1 转换成功 2 转换失败
        “preview”:1 # 是否预习课件 0非预习课件 1预习课件
        }

    ],
    total: 1,  # 总页数
    current: 1 # 当前页数
}

5.文档关联接口

描述：

将账户共享文档与房间关联, 支持批量关联

地址：

https://ccapi.csslcloud.net/api/v1/doc/relate

方法：

GET/POST

请求参数：

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
room_id 字符串 房间ID 必须
doc_id 字符串 文档ID 必须

返回示例:

{
    "result": "OK", # 失败： FAIL，成功：OK
}

6.取消文档关联

描述：

将账户共享文档与房间取消关联, 支持批量取消关联

地址：

https://ccapi.csslcloud.net/api/v1/doc/unrelate

方法：

GET/POST

请求参数：

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
room_id 字符串 房间ID 必须
doc_id 字符串 文档ID 必须

返回示例:

{
    "result": 'OK', # 失败： FAIL，成功：OK
}

7.设置预习课件

描述：

将房间关联的文档设置为预习课件

注意，1、设置预习课件必须是已经关联房间的文档，2、一个房间只能设置一个预习文档

地址：

https://ccapi.csslcloud.net/openapi/v1/doc/preview/set

方法：

GET/POST

请求参数：

参数名称 参数类型 参数说明 备注
accountId 字符串 开发者账号ID 必须
roomId 字符串 房间ID 必须
docId 字符串 文档ID 必须
preview 整型 预习课件标识 必须, 0非预习课件 1预习课件

返回示例:

{
    "result": 'OK', # 失败： FAIL，成功：OK
}

8. 设置文档转码回调通知

描述：

当文档转码成功/失败后，以API POST的方式通知客户

地址：

https://ccapi.csslcloud.net/api/v1/callback/add

备注:

需要THQS加密请求
文档转码完成后, 以POST方式通知的到客户
请求客户API接口参数
{
 "doc_id":"DFDFGGFD54545SFEW34552", # 文档ID
 "convert_status":1 # 转码完成为1 转码失败为3
}
如果客户收到回调通知需返回
{
 "result":"OK"
}

方法：

GET/POST

请求参数：

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
service_name 字符串 请填写 doc 必须
action_name 字符串 请填写 doc_transcode 必须
callback_api 字符串 回调API地址 必须
switch_on 整型 回调开关 1:开启 0:关闭 必须

返回示例:

{
    "result": "OK", # 失败： FAIL，成功：OK
}

9. 取消设置文档转码回调通知

描述：

删除文档回调设置

地址：

https://ccapi.csslcloud.net/api/v1/callback/del

方法：

GET/POST

请求参数:

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
service_name 字符串 请填写 doc 必须
action_name 字符串 请填写 doc_transcode 必须

返回示例:

{
   "result": "OK", # 失败： FAIL，成功：OK
}

10. 更新设置文档转码回调通知

描述：

更新文档回调设置

地址：

https://ccapi.csslcloud.net/api/v1/callback/update

方法：

GET/POST

请求参数:

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
service_name 字符串 请填写 doc 必须
action_name 字符串 请填写 doc_transcode 必须
new_callback_api 字符串 新的回调URL地址 必须

返回示例:

{
    "result": "OK", # 失败： FAIL，成功：OK
}

11. 获取文档下载地址

描述：

获取文档下载地址

地址：

https://ccapi.csslcloud.net/api/v1/doc/download

方法：

GET/POST

请求参数:

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
room_id 字符串 房间ID 必须
doc_id 字符串 文档ID 必须

返回示例:

{
  // 文档信息
  "doc": {
    "uploadFileType": 2,
    "userId": "123",
    "id": "123",
    "md5": "E753B5CBAA0CC2AB62A232767B8667EB",
    "roomId": "123",
    "fileName": "第一讲 二次函数的面积.ppt",
    "useSDK": 0,
    "useSdk": false,
    "pageTitles": [
      "第一讲 二次函数下的面积问题"
    ],
    "pageSize": 12,
    "mode": 0,
    "size": 857600,
    "name": "第一讲 二次函数的面积.ppt"
  },
  // 文档下载地址
  "down_url": "http://doc-origin.csslcloud.net/document/88C79C053AFF11E39C33DC5901307461/CA982990E70632FB.ppt",
  "picDomain": "http://image.csslcloud.net",
  "result": "OK"
}

12. 文档名称重命名

描述：

文档名称重命名

地址：

https://ccapi.csslcloud.net/api/v1/doc/update

方法：

GET/POST

请求参数:

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
doc_name 字符串，长度不超过200 文档名称 必须
doc_id 字符串 文档ID 必须

返回示例:

{
  "result": "OK", # 失败： FAIL，成功：OK
}

13.获取文档详情

描述：

获取用户文档详情数据

地址:

https://ccapi.csslcloud.net/openapi/doc/detail

方法:

GET

请求参数:

参数名称 参数类型 参数说明 备注
accountId 字符串 开发者账号ID 必须
docId 字符串 文件ID 用于查询 必须

返回示例:

{
    "result": "OK", 
    "data": {
        "size": 0, # 文件大小
        "status": 1, 1 # 文档状态  0 上传成功 1 转换成功 2 转换失败
        "docId": "D40E24C314337499", # 文件ID
        "docName": "网易云课堂付费裂变传播教程",# 文件名称 
        "pageSize": 58, # 文件页数
        "docRoomId": "88C79C053AFF11E39C33DC5901307461",  # 共享盘房间ID
        "useSDK": 0, # ppt动效 0: 未开启  1: 开启
        "createTime": "2018-06-19 10:32:27.0", # 上传时间
        "picDomain": "https://image.csslcloud.net"# 实际去访问文档的地址
    }, 
    "errorMsg": ""
}

文档访问地址规则说明：${picDomain}/image/${docRoomId}/${docId}/${page}.jpg
注意：${page} 为该文档的对应页码，从0开始
示例：https://image.csslcloud.net/image/9F2252F04EC4874F9C33DC5901307461/82070E3EDA0ACB8E9C33DC5901307461/0.jpg

14.查询练习历史作答文档信息

描述：

查询练习历史作答文档信息

地址:

https://ccapi.csslcloud.net/openapi/doc/practice/history/doc_info

方法:

GET

请求参数:

参数名称 参数类型 参数说明 备注
accountId 字符串 开发者账号ID 必须
roomId 字符串 直播间ID 必须
liveId 字符串 直播ID 必须
userId 字符串 用户ID 可选
pageSize 整型 页码 可选 (不传userId时生效)
pageLength 整型 条数 可选 (不传userId时生效)

返回示例:

{
    "result":"OK",
    "error":null,
    "data":{
        "total":1,//总条数
        "list":[
            {
                "list":[
                    {
                        "docId":"EBDB77206AB3B7C19C33DC5901307461", //文档id
                        "page":0, //页码
                        "url":"https://image.csslcloud.net/image/9F2252F04EC4874F9C33DC5901307461/EBDB77206AB3B7C19C33DC5901307461/0.jpg", //打开的url
                        "picDomain":"https://image.csslcloud.net", //请求主域名
                        "docRoomId":"9F2252F04EC4874F9C33DC5901307461", //文档的docRoomId
                        "totalPage":50 //总页码
                    }
                ],
                "userId":"1412", //当前用户id
                "userName":"测试用户14" //当前用户名称
            } 
        ]
    },
    "errorMsg":""
}

15.查询练习文档画笔详情

描述：

查询练习文档画笔详情

地址:

https://ccapi.csslcloud.net/openapi/doc/practice/history/draw_detail

方法:

GET

请求参数:

参数名称 参数类型 参数说明 备注
accountId 字符串 开发者账号ID 必须
liveId 字符串 直播ID 必须
userId 字符串 用户ID 必须
docPage 整型 文档页码 必须
docId 字符串 文档ID 必须

返回示例:

{
    "result":"OK",
    "error":null,
    "data":{
        "list":[
            {
              // 用户id
                "viewerid":"1412",
              // 切换画笔类型前的上一个画笔类型
                "preType":2,
              // 画笔颜色
                "color":"00000000",
              // 画笔粗细
                "thickness":0.5,
              // 文档id
                "docid":"EBDB77206AB3B7C19C33DC5901307461",
              // 用户名
                "viewername":"测试用户14",
              // 画笔id
                "drawid":"14121619345723628",
              // 画笔坐标数据
                "draw":[
                    {
                        "x":0.43589285714285714,
                        "y":0.11527777777777778
                    }
                ],
              // 当前画笔类型（2是普通画笔）
                "type":2,
              // 文档转码模式
                "mode":0,
              // 画笔透明度
                "alpha":1,
              // 画笔所在容器宽度
                "width":1470,
              // 文件名称
                "name":"5年级满分班1-10讲试卷.pdf",
              // 使用动画（练习未使用
                "useSDK":false,
              // 字体大小（练习中未使用
                "fontSize":15,
              // 当前页码
                "page":0,
              // 画笔所在容器高度
                "height":2080
            }
        ]
    },
    "errorMsg":""
}

16.获取文档预览地址

描述：

获取文档预览地址

地址:

https://ccapi.csslcloud.net/openapi/doc/preview/url

方法:

GET

请求参数:

参数名称 参数类型 参数说明 备注
accountId 字符串 开发者账号ID 必须
docId 字符串 文档ID 必须

返回示例:

{
    "result":"OK",
    "error":null,
    "data":{
        "previewUrl":"https://image.csslcloud.net/cloudclass/saas/microservice/index.html#/ppt??roomId=85E039F74718B6A69C33DC5901307461&docId=3CD14DF63E9673249C33DC5901307461&token=803eb645f23c43e88dbed70584360463"
    },
    "errorMsg":""
}

17.H5课件批量上传

描述：

H5课件批量上传

地址:

https://ccapi.csslcloud.net/openapi/doc/create/h5

方法:

POST  Content-Type:application/json

请求参数:

{
    "accountId": "5938F047E5F562F0", // 开发者账号id
    "docs": [    // 最多5个
        {
            "docUrl": "https://www.baidu.com",  // 文档地址,不可有特殊字符
            "index": "1",                       // 文档索引,用于返回体对应docId
            "title": "测试h5"                   //  文档标题
        }
    ],
    "time": 1667467556,
    "roomId": "A12826D179A580C49C33DC5901307461",  //房间id
    "hash": "41B2CFC0CD1CD4D2E8336BC9E20A29AC"
}

备注:docs THQS前需要先转为JSON String

返回示例:

{
    "result": "OK",
    "error": null,
    "data": {
        "docs": [
            {
                "index": "1",                               // 请求体传入的索引
                "docId": "521A881920E9CCDC9C33DC5901307461" // 文档ID
            }
        ]
    },
    "errorMsg": ""
}

results matching ""

    No results matching ""