双师设备管理&排课API接口文档
说明
本文档主要用于双师课堂,包括给账号添加区域、指定教室和设备绑定关系等API接口。
请求域名
以下接口请求地址中的${private_domin}
部分需要换成客户的专属域名,具体请参考 专属域名说明
接口
API-1: 添加校区
【功能描述】
给账号添加校区
【请求地址】
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/addZone
【请求参数】
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
zone_unique |
int |
是 |
|
校区唯一编码,必须是数字 |
area_id |
int |
是 |
|
校区所属城市ID |
name |
string |
是 |
|
校区名称,长度不能超过100个字符 |
address |
string |
是 |
|
校区地址,长度不可超过255个字符 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
【返回参数】
参数 |
类型 |
示例 |
描述 |
zone_id |
int |
123 |
校区ID |
【返回示例】
{
"code": 0,
"data": {
"zone_id": 4
},
"msg": "",
"ts": 1516270753
}
API-2: 获取校区列表
【功能描述】
获取校区列表
【请求地址】
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/listZone
【请求参数】
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
page |
int |
是 |
1 |
页码,从1开始 |
page_size |
int |
是 |
10 |
每一页返回的条数,不得超过1000 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
【返回参数】
参数 |
类型 |
示例 |
描述 |
zone_id |
int |
123 |
校区ID |
【返回示例】
{
"code": 0,
"data": {
"total": 2,
"list": [
{
"zone_id": 5,
"zone_unique": 131,
"name": "北京网校",
"address": "北京海淀区",
"create_time": "2018-01-18 18:35:41"
},
{
"zone_id": 1,
"zone_unique": 1,
"name": "湖北校区",
"address": "清和广场",
"create_time": "2018-01-18 11:05:06"
}
]
},
"msg": "",
"ts": 1516273179
}
API-3: 更新校区
【功能描述】
更新校区信息
【请求地址】
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/updateZone
【请求参数】
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
zone_id |
int |
是 |
123 |
校区ID |
area_id |
int |
是 |
|
校区所属城市ID |
name |
string |
是 |
|
校区名称,长度不能超过100个字符 |
address |
string |
是 |
|
校区地址,长度不可超过255个字符 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
【返回参数】
参数 |
类型 |
示例 |
描述 |
zone_id |
int |
123 |
校区ID |
【返回示例】
{
"code": 0,
"data": {
"zone_id": 2
},
"msg": "",
"ts": 1516279076
}
API-4: 删除校区
【功能描述】
删除校区,如果校区下有录入设备,则不能删除。
【请求地址】
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/deleteZone
【请求参数】
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
zone_id |
int |
是 |
123 |
校区ID |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
【返回参数】
参数 |
类型 |
示例 |
描述 |
zone_id |
int |
123 |
校区ID |
【返回示例】
{
"code": 0,
"data": {
"zone_id": 2
},
"msg": "",
"ts": 1516279076
}
API-5: 获取设备列表
【功能描述】
获取设备列表
【请求地址】
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/listDevice
【请求参数】
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
zone_id |
int |
否 |
|
校区ID,如果不传则是获取所有校区的设备 |
page |
int |
是 |
1 |
页码,从1开始 |
page_size |
int |
是 |
10 |
每一页返回的条数,不得超过1000 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
【返回参数】
参数 |
类型 |
示例 |
描述 |
device_id |
int |
123 |
设备ID |
device_unique |
string |
ADLK-EKJS-KLJA-AFDL |
设备唯一标志 |
zone_id |
int |
123 |
校区ID |
user_role |
int |
1 |
身份 0:学生 1:老师 |
class_name |
string |
双师试讲教室 |
设备安装的教室名称 |
address |
string |
湖北省武汉市洪山区 |
设备安装地址 |
create_time |
string |
2018-01-19 13:00:23 |
添加时间 |
install_date |
string |
2018-01-19 |
安装日期 |
first_active_date |
string |
2018-01-19 |
初次激活日期 |
max_user |
int |
10 |
最大人数 |
confirm_pic |
string |
|
现场施工确认单 |
class_spot |
array |
|
教室施工现场 |
province |
string |
|
省份 |
city |
string |
|
城市 |
【返回示例】
{
"code": 0,
"data": {
"total": 1,
"list": [
{
"device_id": 4,
"device_unique": "AEFOIJ-23FKJ-23KJA-213",
"zone_id": 3,
"user_role": 0,
"class_name": "湖北华图中禹厅",
"address": "清河广场4楼",
"create_time": "2018-01-19 10:34:56",
"install_date": "2018-01-19",
"first_active_date": "2018-01-19",
"max_user": 10,
"confirm_pic": "http://test-img.baijiayun.com/baijiacloud/1092645_xtor6wkq.jpg",
"class_spot": [
"http://test-img.baijiayun.com/baijiacloud/1092645_xtor6wkq.jpg",
"http://test-img.baijiayun.com/baijiacloud/1092645_xtor6wkq.jpg",
],
"province": "湖北",
"city": "武汉"
}
]
},
"msg": "",
"ts": 1516332055
}
API-6: 更新双师设备信息
【功能描述】
更新双师设备信息
【请求地址】
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/updateDeviceInfo
【请求参数】
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
device_id |
int |
是 |
123 |
设备号 |
class_name |
string |
否 |
教室1 |
教室名 |
zone_id |
int |
否 |
123 |
设备所在校区id |
address |
string |
否 |
武汉 |
设备安装地址 |
user_role |
int |
否 |
1 |
身份 0:学生 1:老师 |
use_type |
int |
否 |
1 |
1:使用排课系统 2:不使用排课系统 |
status |
int |
否 |
1 |
设备禁用 0:正常 1:禁用 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
【返回参数】
参数 |
类型 |
示例 |
描述 |
device_id |
int |
123 |
设备号 |
【返回示例】
{
"code": 0,
"data": {
"device_id": 3
},
"msg": "",
"ts": 1516270146
}
API-7: 给课程绑定设备
【功能描述】
给课程指定相关的老师或学生设备
【请求地址】
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/bindDevice
【请求参数】
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
room_id |
int |
是 |
123234567124414 |
直播教室号 |
device_id |
int |
是 |
123 |
设备号 |
user_role |
int |
是 |
0 |
角色 0:学生 1:老师 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
【返回参数】
参数 |
类型 |
示例 |
描述 |
bind_id |
int |
123 |
绑定成功的id号,用户可不用保存该值 |
【返回示例】
{
"code": 0,
"data": {
"bind_id": 3
},
"msg": "",
"ts": 1516270146
}
API-8: 批量给课程绑定学员设备
【功能描述】
批量给课程指定学员设备
【请求地址】
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/bindStudentDeviceBatch
【请求参数】
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
room_id |
int |
是 |
123234567124414 |
直播教室号 |
device_ids |
string |
是 |
123,456 |
设备号,多个设备号以英文逗号分隔 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
【返回参数】
参数 |
类型 |
示例 |
描述 |
succ_list |
array |
123 |
绑定成功的设备id号,用户可不用保存该值 |
【返回示例】
{
"code": 0,
"data": {
"succ_list": [
11,
13,
12
]
},
"msg": "",
"ts": 1516876352
}
API-9: 设备绑定多个课程
【功能描述】
批量给设备绑定多个课程
【请求地址】
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/bindRoomBatch
【请求参数】
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
room_ids |
string |
是 |
1234,5678,4567 |
直播教室号 |
device_id |
int |
是 |
1234 |
设备id |
user_role |
int |
是 |
0/1 |
0:学生端 1:老师端 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
【返回参数】
参数 |
类型 |
示例 |
描述 |
succ_list |
array |
[123,233] |
成功的教室号 |
【返回示例】
{
"code": 0,
"data": {
"succ_list": [
123456789,
232423424,
]
},
"msg": "",
"ts": 1539064696
}
API-10: 解除课程与设备关联
【功能描述】
解除课程与设备的关联
【请求地址】
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/unbindDevice
【请求参数】
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
room_id |
int |
是 |
123234567124414 |
直播教室号 |
device_id |
int |
是 |
123 |
设备号 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
【返回参数】
参数 |
类型 |
示例 |
描述 |
bind_id |
int |
123 |
绑定成功的id号,用户可不用保存该值 |
【返回示例】
{
"code": 0,
"data": {
"bind_id": 3
},
"msg": "",
"ts": 1516270146
}
API-11: 批量解除课程与设备关联
【功能描述】
解除课程与设备的关联
【请求地址】
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/unbindDeviceBatch
【请求参数】
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
room_id |
int |
是 |
123234567124414 |
直播教室号 |
device_ids |
int |
是 |
123 |
设备号 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
【返回参数】
参数 |
类型 |
示例 |
描述 |
bind_id |
int |
123 |
绑定成功的id号,用户可不用保存该值 |
【返回示例】
{
"code": 0,
"data": {
"count": 3
},
"msg": "",
"ts": 1516270146
}
API-12: 更新课程绑定的全部学生端
【功能描述】
更新全部的学生端设备。相当于把之前的绑定关系清除掉,设置成当前这一批。
【请求地址】
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/setAllStudentDevice
【请求参数】
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
room_id |
int |
是 |
123234567124414 |
直播教室号 |
device_ids |
string |
是 |
123,456 |
设备号,多个设备号以英文逗号分隔 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
【返回参数】
参数 |
类型 |
示例 |
描述 |
count |
int |
123 |
总共的学生端数量 |
【返回示例】
{
"code": 0,
"data": {
"count": 3
},
"msg": "",
"ts": 1516876352
}
API-13: 获取直播房间关联的设备信息
【功能描述】
获取直播房间关联的设备信息
【请求地址】
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/getRoomDeviceInfo
【请求参数】
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
room_id |
int |
是 |
123 |
直播教室号 |
page |
int |
是 |
1 |
页码,从1开始 |
page_size |
int |
是 |
10 |
每一页返回的条数,不得超过1000 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
【返回参数】
参数 |
类型 |
示例 |
描述 |
device_id |
int |
123 |
设备号 |
device_unique |
string |
AAAAA8BD7A3DF5C5869015854703D7F5 |
设备码 |
zone_id |
int |
123 |
设备所在校区id |
class_name |
string |
教室1 |
教室名 |
address |
string |
武汉 |
设备安装地址 |
user_role |
int |
1 |
身份 0:学生 1:老师 |
use_type |
int |
1 |
1:使用排课系统 2:不使用排课系统 |
status |
int |
0 |
设备禁用 0:正常 1:禁用 |
【返回示例】
{
"code": 0,
"data": {
"room_device_list": [
{
"device_id": 18,
"device_unique": "F3CC854E3AB174DCC0EE2B1C17392F02",
"zone_id": 12,
"class_name": "教室",
"address": "北京",
"user_role": 0,
"use_type": 2,
"status": 0
},
{
"device_id": 19,
"device_unique": "FC986991E4C54C70E9796660D53EA9B4",
"zone_id": 12,
"class_name": "老师教室",
"address": "武汉",
"user_role": 1,
"use_type": 1,
"status": 0
}
],
'total':2
},
"msg": "",
"ts": 1539064696
}
API-14: 获取设备最近一次激活记录
【功能描述】
获取设备列表
【请求地址】
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/getRecentActivateRecord
【请求参数】
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
device_id |
int |
是 |
123 |
设备号 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
【返回参数】
参数 |
类型 |
示例 |
描述 |
device_id |
int |
123 |
设备ID |
device_unique |
string |
ADLK-EKJS-KLJA-AFDL |
设备唯一标志 |
activate_record |
array |
|
激活码激活记录 |
【返回示例】
{
"code": 0,
"data": {
"device_id": 4,
"device_unique": "AEFOIJ-23FKJ-23KJA-213",
"activate_record":{
"activate_time": "2020-02-09 16:27:36",
"activate_length": 123,
}
},
"msg": "",
"ts": 1516332055
}
排课信息接口
排课信息接口,主要用于设置在双师教室里面显示的排课信息。回放的生成和裁剪加依据此排课信息进行。
每个课节需要有一个自己的序列号serial_number
,每个课程下课节序列号需要唯一。
回放生成后会自动按排课信息来裁剪,裁剪后的回放与课节的关联,是通过room_id + serial_number
来关联。
设备课程基本信息
设置/更新课程的标题、老师信息
请求地址
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/setRoomScheduleInfo
请求参数
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
room_id |
int |
是 |
123 |
直播教室号 |
title |
string |
是 |
英语 |
课程标题 |
teacher_name |
string |
否 |
英语 |
课程老师 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
返回参数
{
"code": 0,
"data": null
}
更新教室课节信息(全量)
设置/更新课程整体的排课信息,该操作会覆盖课程下所有的课节
请求地址
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/setRoomSchedules
请求参数
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
room_id |
int |
是 |
123 |
直播教室号 |
title |
string |
否 |
英语 |
课程标题 |
teacher_name |
string |
否 |
英语 |
课程老师 |
schedule |
string |
是 |
|
json格式的课节信息表 |
schedule[].serial_number |
string |
是 |
|
课节编号,同一课程同一天的课节编号不可重复,更新排课信息时需要此编号 |
schedule[].date |
string |
是 |
2018-11-15 |
日期,格式如:2018-01-03 |
schedule[].title |
string |
是 |
|
课节标题 |
schedule[].start_time |
string |
是 |
|
开始时间 |
schedule[].end_time |
string |
是 |
|
结束时间 |
schedule[].teacher_name |
string |
否 |
|
主讲老师姓名(非必填) |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
其中schedule
是json格式的字符串,格式如下:
[
{
"date": "2018-11-19",
"serial_number": 123,
"title": "课节标题",
"start_time": "09:00",
"end_time": "09:45",
"teacher_name": "老师名称"
},
{
"date": "2018-11-19",
"serial_number": 124,
"title": "课节标题",
"start_time": "10:00",
"end_time": "10:45",
"teacher_name": "老师名称"
}
]
返回参数
{
"code": 0,
"data": null
}
添加单个课节
添加单个课节,同一教室同一天的serial_number
不能与之前已存在的重复
请求地址
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/addSchedule
请求参数
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
room_id |
int |
是 |
123 |
直播教室号 |
serial_number |
string |
是 |
|
课节编号,同一课程同一天的课节编号不可重复,更新排课信息时需要此编号 |
date |
string |
是 |
2018-11-15 |
日期,格式如:2018-01-03 |
title |
string |
是 |
|
课节标题 |
start_time |
string |
是 |
|
开始时间 |
end_time |
string |
是 |
|
结束时间 |
teacher_name |
string |
否 |
|
主讲老师姓名(非必填) |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
返回参数
返回示例
{
"code": 0,
"data": null,
"msg": "",
"ts": 1539064696
}
更新单个课节
更新单个课节,根据room_id + serial_number
来唯一确定更新记录
请求地址
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/updateSchedule
请求参数
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
room_id |
int |
是 |
123 |
直播教室号 |
serial_number |
int |
是 |
|
课节编号,同一课程同一天的课节编号不可重复,更新排课信息时需要此编号 |
date |
string |
是 |
2018-11-15 |
日期,格式如:2018-01-03 |
title |
string |
是 |
|
课节标题 |
start_time |
string |
是 |
|
开始时间 |
end_time |
string |
是 |
|
结束时间 |
teacher_name |
string |
否 |
|
主讲老师姓名(非必填) |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
删除课节(批量)
批量删除课节,根据room_id + serial_number
来唯一确定删除的课节,serial_numbers
可以传多个课节编号,以英文逗号分隔。
请求地址
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/deleteScheduleBatch
请求参数
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
room_id |
int |
是 |
123 |
直播教室号 |
serial_numbers |
string |
是 |
|
课节编号,同一课程同一天的课节编号不可重复,更新排课信息时需要此编号 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
返回参数
返回示例
{
"code": 0,
"data": null,
"msg": "",
"ts": 1539064696
}
清除指定教室下所有的课节
删除指定教室所有课节信息
请求地址
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/deleteAllSchedule
请求参数
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
room_id |
int |
是 |
123 |
直播教室号 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
返回参数
返回示例
{
"code": 0,
"data": null,
"msg": "",
"ts": 1539064696
}
获取教室下所有的课节
获取指定教室下的所有课节信息
请求地址
https://${private_domain}.at.baijiayun.com/openapi/double_teacher/getAllSchedule
请求参数
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
room_id |
int |
是 |
123 |
直播教室号 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
返回参数
返回示例
{
"code": 0,
"data": {
"list": [
{
"id": 11,
"partner_id": 37102096,
"room_id": 18020796069152,
"date": "2018-11-20",
"title": "英文",
"serial_number": 1,
"start_time": "2018-11-20 20:20:00",
"end_time": "2018-11-20 21:20:00",
"teacher_name": "老虎",
"create_time": "2018-11-20 20:23:24",
"update_time": "2018-11-20 20:23:24"
},
{
"id": 12,
"partner_id": 37102096,
"room_id": 18020796069152,
"date": "2018-11-21",
"title": "日语",
"serial_number": 2,
"start_time": "2018-11-21 10:00:00",
"end_time": "2018-11-21 11:00:00",
"teacher_name": "猴子",
"create_time": "2018-11-20 20:32:36",
"update_time": "2018-11-20 20:32:36"
}
]
},
"msg": "",
"ts": 1542717158
}
回调接口
新增设备回调
接口描述
新增设备后,百家云会回调通知客户,回调信息里包含新增的设备ID等信息。
如果回调失败,会在间隔5秒、60秒后分别重试两次,之后不再重试。
客户记录设备信息时因根据设备ID去重。
回调地址
需要联系百家云技术配置
回调参数
参数 |
类型 |
是否必填 |
示例 |
描述 |
type |
string |
是 |
add_device |
添加设备:add_device |
device_id |
int |
是 |
123 |
设备号 |
device_unique |
string |
是 |
|
设备唯一标志 |
zone_id |
int |
是 |
123 |
校区ID |
class_name |
string |
是 |
0 |
设备安装的教室名 |
address |
string |
是 |
0 |
设备安装地址 |
user_role |
int |
是 |
0 |
角色 0:学生 1:老师 |
qid |
string |
是 |
0 |
请求唯一标志,字符串 |
timestamp |
int |
是 |
1460426400 |
当前时间,unix时间戳 |
sign |
string |
是 |
|
签名 |
返回标准
合作方接收后应返回一段json,包含一个code,0表示成功,非0表示失败。
{
"code": 0,
"msg": ""
}
{
"code": 1,
"msg": "错误信息"
}
回放自动匹配回调
接口描述
该接口用于按排课信息自动匹配后的回调。
回调地址
需要联系百家云技术配置
请求参数
参数 |
类型 |
是否必填 |
示例 |
描述 |
partner_id |
int |
是 |
123456 |
账号ID |
room_id |
int |
是 |
123 |
直播教室号 |
serial_number |
string |
是 |
|
课节编号,同一课程同一天的课节编号不可重复,更新排课信息时需要此编号 |
session_id |
int |
是 |
123132313 |
回放的session_id |
video_id |
int |
是 |
123 |
回放视频ID |
status |
int |
是 |
20 |
回放状态(30:转码失败 100:转码成功) |
preface_url |
string |
是 |
|
封面url,(转码成功回调才有) |
total_size |
int |
是 |
123 |
视频大小,单位是字节 |
total_transcode_size |
int |
是 |
123 |
总视频大小(源文件+所有转码后文件)单位:字节(转码成功回调才有) |
length |
int |
是 |
123 |
视频时长,单位为秒(转码成功回调才有) |
file_md5 |
string |
是 |
abcdefagea |
视频文件md5值 |
now_definition |
string |
是 |
|
当前已转出的清晰度,多种清晰度以英文逗号分隔 low/std/high/super/1080p(转码成功回调才有) |
origin_definition |
string |
是 |
|
原始视频清晰度 low/std/high/super/1080p(转码成功回调才有) |
qid |
string |
是 |
123456789 |
标记一次请求的唯一ID |
timestamp |
int |
是 |
1234567 |
unixstamp时间戳,秒数 |
sign |
string |
是 |
abcdefagea |
签名字段 |
返回标准
合作方接收后应返回一段json,包含一个code,0表示成功,非0表示失败。
{
"code": 0,
"msg": ""
}
{
"code": 1,
"msg": "错误信息"
}