501 lines
7.7 KiB
Plaintext
501 lines
7.7 KiB
Plaintext
|
壹动站对接协议
|
|||
|
|
2025年5月
|
|||
|
|
深圳前海壹路科技有限公司
|
|||
|
|
修订记录
|
|||
|
|
日期
|
|||
|
|
版本
|
|||
|
|
修改人
|
|||
|
|
修改描述
|
|||
|
|
20241203
|
|||
|
|
V1.0
|
|||
|
|
曹向
|
|||
|
|
新建壹动站和学校智慧体育平台的对接协议
|
|||
|
|
20250506
|
|||
|
|
V1.1
|
|||
|
|
曹向
|
|||
|
|
接口字段含义和类型说明
|
|||
|
|
20250624
|
|||
|
|
V1.3
|
|||
|
|
唐明冠
|
|||
|
|
新增二、(5、6、7) 服务器推送远程标定相关协议
|
|||
|
|
20250626
|
|||
|
|
V1.4
|
|||
|
|
唐明冠
|
|||
|
|
新增一、获取人员详情接口
|
|||
|
|
20250704
|
|||
|
|
V1.5
|
|||
|
|
唐明冠
|
|||
|
|
修改一、2人员下发接口(新增后台回传字段current,pages,total用于实时监测下发进度)
|
|||
|
|
20250707
|
|||
|
|
V1.6
|
|||
|
|
唐明冠
|
|||
|
|
增加“服务器主动推送获取设备标定现场参照图”接口备注
|
|||
|
|
20250718
|
|||
|
|
V1.7
|
|||
|
|
曹向
|
|||
|
|
修改人员下发相关接口新增年级名称字段
|
|||
|
|
20250722
|
|||
|
|
V1.8
|
|||
|
|
唐明冠
|
|||
|
|
一
|
|||
|
|
、
|
|||
|
|
10查询我的运动新增选填字段 身高
|
|||
|
|
、
|
|||
|
|
体重
|
|||
|
|
20250822
|
|||
|
|
V1.9
|
|||
|
|
曹向
|
|||
|
|
增加组织下发接口
|
|||
|
|
壹动站调用平台接口部分
|
|||
|
|
1、小站登录
|
|||
|
|
后台小站的状态通过小站登录之后显示为在线，当小站中断心跳三分钟后离线，离线后需要重新调用该接口重新登录
|
|||
|
|
WebSocket地址：ws://192.168.51.36:22001/ws/camera/device
|
|||
|
|
客户端请求示例：
|
|||
|
|
{
|
|||
|
|
|
|||
|
|
"serialNumber"
|
|||
|
|
:
|
|||
|
|
"sn1881"
|
|||
|
|
,
|
|||
|
|
//序列码，区分设备唯一性
|
|||
|
|
|
|||
|
|
"androidId"
|
|||
|
|
:
|
|||
|
|
""
|
|||
|
|
,
|
|||
|
|
//安卓Id，本次后端没用到，李总要求保留该字段
|
|||
|
|
|
|||
|
|
"imei"
|
|||
|
|
:
|
|||
|
|
""
|
|||
|
|
,
|
|||
|
|
//国际移动设备识别码，本次后端没用到，李总要求保留该字段
|
|||
|
|
|
|||
|
|
"imsi"
|
|||
|
|
:
|
|||
|
|
""
|
|||
|
|
,
|
|||
|
|
//国际移动用户识别码，本次后端没用到，李总要求保留该字段
|
|||
|
|
"request"
|
|||
|
|
:
|
|||
|
|
"station:live"
|
|||
|
|
,
|
|||
|
|
//
|
|||
|
|
|
|||
|
|
请求类型
|
|||
|
|
"msgId"
|
|||
|
|
:
|
|||
|
|
"c7e6a04a5f3842d8b7f343d35d05d923"
|
|||
|
|
|
|||
|
|
//消息随机码，随机字符串，确保对话消息对称性
|
|||
|
|
}
|
|||
|
|
服务器返回示例：
|
|||
|
|
{
|
|||
|
|
|
|||
|
|
"msgId"
|
|||
|
|
:
|
|||
|
|
"c7e6a04a5f3842d8b7f343d35d05d923"
|
|||
|
|
,
|
|||
|
|
|
|||
|
|
"request"
|
|||
|
|
:
|
|||
|
|
"station:live"
|
|||
|
|
,
|
|||
|
|
|
|||
|
|
"data"
|
|||
|
|
: {
|
|||
|
|
|
|||
|
|
"sportStationId"
|
|||
|
|
:
|
|||
|
|
0
|
|||
|
|
,
|
|||
|
|
//运动小站id
|
|||
|
|
|
|||
|
|
"name"
|
|||
|
|
:
|
|||
|
|
""
|
|||
|
|
,
|
|||
|
|
//运动小站名称
|
|||
|
|
|
|||
|
|
"tenantName"
|
|||
|
|
:
|
|||
|
|
""
|
|||
|
|
,
|
|||
|
|
//客户名称
|
|||
|
|
|
|||
|
|
"serialNumber"
|
|||
|
|
:
|
|||
|
|
""
|
|||
|
|
,
|
|||
|
|
//唯一序列号
|
|||
|
|
|
|||
|
|
"isCalibration"
|
|||
|
|
:
|
|||
|
|
0
|
|||
|
|
,
|
|||
|
|
//是否标定
|
|||
|
|
|
|||
|
|
"isSynchronization"
|
|||
|
|
:
|
|||
|
|
0
|
|||
|
|
,
|
|||
|
|
//是否开启数据同步
|
|||
|
|
|
|||
|
|
"isActive"
|
|||
|
|
:
|
|||
|
|
0
|
|||
|
|
,
|
|||
|
|
//是否激活
|
|||
|
|
|
|||
|
|
"courseList"
|
|||
|
|
: [
|
|||
|
|
//课程列表，每个课目的id和名称对应
|
|||
|
|
{
|
|||
|
|
|
|||
|
|
"courseId"
|
|||
|
|
:
|
|||
|
|
0
|
|||
|
|
, //课目类型id 见备注
|
|||
|
|
|
|||
|
|
"courseName"
|
|||
|
|
:
|
|||
|
|
""//课目名称
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
},
|
|||
|
|
|
|||
|
|
"msg"
|
|||
|
|
:
|
|||
|
|
"OK"
|
|||
|
|
,
|
|||
|
|
|
|||
|
|
"code"
|
|||
|
|
:
|
|||
|
|
0
|
|||
|
|
}
|
|||
|
|
请求报文字段说明
|
|||
|
|
字段
|
|||
|
|
类型
|
|||
|
|
说明
|
|||
|
|
是否必填
|
|||
|
|
备注
|
|||
|
|
request
|
|||
|
|
String
|
|||
|
|
请求类型
|
|||
|
|
是
|
|||
|
|
必须与示例相同：station:live
|
|||
|
|
msgId
|
|||
|
|
String
|
|||
|
|
消息随机码
|
|||
|
|
是
|
|||
|
|
随机字符串，确保对话消息对称性
|
|||
|
|
serialNumber
|
|||
|
|
String
|
|||
|
|
序列码，区分设备唯一性
|
|||
|
|
是
|
|||
|
|
androidId
|
|||
|
|
String
|
|||
|
|
安卓Id
|
|||
|
|
否
|
|||
|
|
预留字段，可不作处理
|
|||
|
|
imei
|
|||
|
|
String
|
|||
|
|
国际移动设备识别码
|
|||
|
|
否
|
|||
|
|
预留字段，可不作处理
|
|||
|
|
imsi
|
|||
|
|
String
|
|||
|
|
国际移动用户识别码
|
|||
|
|
否
|
|||
|
|
预留字段，可不作处理
|
|||
|
|
响应报文字段说明
|
|||
|
|
字段
|
|||
|
|
类型
|
|||
|
|
说明
|
|||
|
|
是否必填
|
|||
|
|
备注
|
|||
|
|
request
|
|||
|
|
String
|
|||
|
|
请求类型
|
|||
|
|
是
|
|||
|
|
必须与示例相同：station:live
|
|||
|
|
msgId
|
|||
|
|
String
|
|||
|
|
消息随机码
|
|||
|
|
是
|
|||
|
|
随机字符串，确保对话消息对称性
|
|||
|
|
data
|
|||
|
|
Object
|
|||
|
|
返回体
|
|||
|
|
是
|
|||
|
|
msg
|
|||
|
|
String
|
|||
|
|
返回信息
|
|||
|
|
是
|
|||
|
|
code
|
|||
|
|
Integer
|
|||
|
|
返回码
|
|||
|
|
是
|
|||
|
|
sportStationId
|
|||
|
|
Integer
|
|||
|
|
运动小站id
|
|||
|
|
是
|
|||
|
|
name
|
|||
|
|
String
|
|||
|
|
运动小站名称
|
|||
|
|
是
|
|||
|
|
tenantName
|
|||
|
|
String
|
|||
|
|
客户名称
|
|||
|
|
是
|
|||
|
|
serialNumber
|
|||
|
|
String
|
|||
|
|
唯一序列号
|
|||
|
|
是
|
|||
|
|
isCalibration
|
|||
|
|
Integer
|
|||
|
|
是否标定
|
|||
|
|
是
|
|||
|
|
isSynchronization
|
|||
|
|
Integer
|
|||
|
|
是否开启数据同步
|
|||
|
|
是
|
|||
|
|
0 否 1是
|
|||
|
|
courseList
|
|||
|
|
List
|
|||
|
|
课程列表
|
|||
|
|
否
|
|||
|
|
每个课目的id和名称对应
|
|||
|
|
courseId
|
|||
|
|
Integer
|
|||
|
|
课目类型id
|
|||
|
|
否
|
|||
|
|
见备注
|
|||
|
|
courseName
|
|||
|
|
String
|
|||
|
|
课目名称
|
|||
|
|
否
|
|||
|
|
见备注
|
|||
|
|
2、人员下发
|
|||
|
|
测试地址（弃用）：
|
|||
|
|
192.168.51.36:22001/device/sync/user_trace
|
|||
|
|
修改接口地址为:
|
|||
|
|
192.168.51.36:22001/device/sync/user_page
|
|||
|
|
|
|||
|
|
请求类型：POST
|
|||
|
|
请求参数示例：
|
|||
|
|
{
|
|||
|
|
|
|||
|
|
"deviceSerial"
|
|||
|
|
:
|
|||
|
|
"fa0132e389448588"
|
|||
|
|
, //设备序列号
|
|||
|
|
|
|||
|
|
"deviceType"
|
|||
|
|
:
|
|||
|
|
11
|
|||
|
|
, //设备类型
|
|||
|
|
"userType"
|
|||
|
|
:
|
|||
|
|
2 //人员类型 1教师，2 学生
|
|||
|
|
|
|||
|
|
"pageIndex"
|
|||
|
|
:
|
|||
|
|
1
|
|||
|
|
,
|
|||
|
|
//分页页码
|
|||
|
|
|
|||
|
|
"pageSize"
|
|||
|
|
:
|
|||
|
|
10 //分页个数
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
返回参数示例：
|
|||
|
|
{
|
|||
|
|
|
|||
|
|
"code"
|
|||
|
|
:
|
|||
|
|
0
|
|||
|
|
,
|
|||
|
|
|
|||
|
|
"msg"
|
|||
|
|
:
|
|||
|
|
"OK"
|
|||
|
|
,
|
|||
|
|
|
|||
|
|
"data"
|
|||
|
|
: {
|
|||
|
|
|
|||
|
|
"syncId"
|
|||
|
|
:
|
|||
|
|
215055665
|
|||
|
|
, //同步id
|
|||
|
|
"current"
|
|||
|
|
:
|
|||
|
|
1
|
|||
|
|
, //当前查询页码
|
|||
|
|
"pages"
|
|||
|
|
:
|
|||
|
|
10
|
|||
|
|
, //当前页码总数
|
|||
|
|
"total"
|
|||
|
|
:
|
|||
|
|
1000
|
|||
|
|
, //所有数据总人数
|
|||
|
|
|
|||
|
|
"userList"
|
|||
|
|
: [
|
|||
|
|
{
|
|||
|
|
|
|||
|
|
"userId"
|
|||
|
|
:
|
|||
|
|
2762
|
|||
|
|
,
|
|||
|
|
//人员id
|
|||
|
|
|
|||
|
|
"userType"
|
|||
|
|
:
|
|||
|
|
2
|
|||
|
|
,
|
|||
|
|
//人员类型，1：教师、2：学生，3：家长（仅app支持）
|
|||
|
|
|
|||
|
|
"username"
|
|||
|
|
:
|
|||
|
|
"0201009"
|
|||
|
|
,
|
|||
|
|
//用户名，（登录用）
|
|||
|
|
|
|||
|
|
"nickname"
|
|||
|
|
:
|
|||
|
|
"陈志强"
|
|||
|
|
,
|
|||
|
|
//姓名
|
|||
|
|
|
|||
|
|
"organizationId"
|
|||
|
|
:
|
|||
|
|
231
|
|||
|
|
,
|
|||
|
|
//组织id
|
|||
|
|
|
|||
|
|
|
|||
|
|
"organizationName": "一班", //
|
|||
|
|
具体组织
|
|||
|
|
名称
|
|||
|
|
（
|
|||
|
|
班级
|
|||
|
|
）
|
|||
|
|
|
|||
|
|
|
|||
|
|
"grade
|
|||
|
|
Name
|
|||
|
|
": "二年级", //
|
|||
|
|
年级
|
|||
|
|
名称
|
|||
|
|
|
|||
|
|
"facePictureUrl"
|
|||
|
|
:
|
|||
|
|
"http://192.168.51.36:9000/user-face-picture/18095480862818631680201009.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=minioadmin%2F20240812%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20240812T095444Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Signature=7a98374f95b49d0be67c78329523d97b2888d21841cc69c6256909f23e3bc7b3"
|
|||
|
|
,
|
|||
|
|
//人脸图片链接
|
|||
|
|
|
|||
|
|
"identity"
|
|||
|
|
:
|
|||
|
|
"学生"
|
|||
|
|
,
|
|||
|
|
//身份 userType对应属性
|
|||
|
|
|
|||
|
|
"gender"
|
|||
|
|
:
|
|||
|
|
"男"
|
|||
|
|
,
|
|||
|
|
//性别
|
|||
|
|
|
|||
|
|
"birthday"
|
|||
|
|
:
|
|||
|
|
"1999-06-25"
|
|||
|
|
,
|
|||
|
|
//生日
|
|||
|
|
|
|||
|
|
"userSerial"
|
|||
|
|
:
|
|||
|
|
"0201009"
|
|||
|
|
,
|
|||
|
|
//人员编码，对应本地U盘导入人员序列号
|
|||
|
|
|
|||
|
|
"trainLimitValues"
|
|||
|
|
: [
|
|||
|
|
//训练极致
|
|||
|
|
{
|
|||
|
|
|
|||
|
|
"courseId"
|
|||
|
|
:
|
|||
|
|
8
|
|||
|
|
,
|
|||
|
|
//课目id ，不同课目id对应不同课目
|
|||
|
|
|
|||
|
|
"bestResult"
|
|||
|
|
:
|
|||
|
|
"23"
|
|||
|
|
,
|
|||
|
|
//该课目最佳成绩
|
|||
|
|
|
|||
|
|
"lastResult"
|
|||
|
|
:
|
|||
|
|
"23"
|
|||
|
|
|
|||
|
|
//该课目最差成绩
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
|
|||
|
|
"courseId"
|
|||
|
|
:
|
|||
|
|
2
|
|||
|
|
,
|
|||
|
|
|
|||
|
|
"bestResult"
|
|||
|
|
:
|
|||
|
|
"0"
|
|||
|
|
,
|
|||
|
|
|
|||
|
|
"lastResult"
|
|||
|
|
:
|
|||
|
|
"0"
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
|
|||
|
|
"courseId"
|
|||
|
|
:
|
|||
|
|
7
|
|||
|
|
,
|
|||
|
|
|
|||
|
|
"bestResult"
|
|||
|
|
:
|
|||
|
|
"16700"
|
|||
|
|
,
|
|||
|
|
|
|||
|
|
"lastResult"
|
|||
|
|
:
|
|||
|
|
"16700"
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
|
|||
|
|
"courseId"
|
|||
|
|
:
|
|||
|
|
9
|
|||
|
|
,
|
|||
|
|
|
|||
|
|
"bestResult"
|
|||
|
|
:
|
|||
|
|
"20"
|
|||
|
|
,
|
|||
|
|
|
|||
|
|
"lastResult"
|
|||
|
|
:
|
|||
|
|
"20"
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
|
|||
|
|
"courseId"
|
|||
|
|
:
|
|||
|
|
10
|