1. 增量查询学生成长记录
1.1. 协议
- REST-URL:
/score/getBatchGrowthRecords
- REST-HTTP-Method:
POST
- COUTENT-TYPE:
application/x-www-form-urlencoded; charset=UTF-8
1.2. 请求参数
公共参数: 点击查看
业务参数:
字段名称 |
类型 |
长度 |
是否必填 |
字段说明 |
studentNo |
String |
64 |
NO |
学生学号(不填写则按时间返回所有学生成长记录信息) |
updateTime |
String |
64 |
NO |
更新标识(非时间格式,用普通字符串格式字段来存储),2021-08-12 12:05:03.291376_12349,增量查询使用,第一次查询不需要填写,接口返回的数据是按照updateTime升序排列,第二次之后依次使用上一次查询时接口返回数据的最后一条数据的updateTime字段,作为下一次调用接口的参数传回,依次循环即可获取所有的数据。增量查询接口调用频率200毫秒。 |
1.3. 响应参数
字段名称 |
类型 |
字段说明 |
data |
String |
如果有数据返回内容 |
success |
Boolean |
请求处理结果状态 |
msg |
String |
接口调用结果提示信息 |
code |
String |
状态码 |
data 数据:
字段名称 |
类型 |
长度 |
是否必填 |
字段说明 |
list |
List |
|
YES |
学分信息 |
list 数据:
字段名称 |
类型 |
长度 |
是否必填 |
字段说明 |
identificationCode |
String |
32 |
YES |
唯一识别码,可用接口调用方避免重复。根据该字段判断本地是否已经存在该条记录,如存在做更新操作。 |
collegeId |
String |
32 |
YES |
学院id |
collegeName |
String |
128 |
YES |
学院名称 |
studentNo |
String |
32 |
YES |
学号 |
studentName |
String |
32 |
YES |
学生姓名 |
startTime |
String |
32 |
YES |
开始时间 如:2019-03-27 11:01:26 |
endTime |
String |
32 |
YES |
结束时间 如:2019-03-27 11:01:26 |
categoryName |
String |
32 |
YES |
一级分类名称 |
typeName |
String |
32 |
YES |
二级分类名称 |
chanel |
String |
32 |
YES |
来源,如:活动/部落/补录/个人申请 |
activityId |
int |
11 |
NO |
活动id,来源是“活动”时会有该字段 |
activityName |
String |
256 |
NO |
活动名称,来源是“活动”时会有该字段 |
locusContent |
String |
512 |
YES |
成长记录内容 |
locusLevel |
String |
32 |
YES |
活动级别 如:院系/校级 |
isCancel |
String |
32 |
YES |
撤销标记 如:正常/已撤销 |
delflag |
String |
32 |
YES |
删除标记 如:正常/已删除 |
updateTime |
String |
32 |
YES |
2021-08-12 12:05:03.291376_12349,更新标识(非时间格式,用普通字符串格式字段来存储),作为批量获取数据接口的增量查询使用 |
prizelist |
List |
|
NO |
奖项 |
scorelist |
List |
|
NO |
学分 |
prizelist数据:
字段名称 |
类型 |
长度 |
是否必填 |
字段说明 |
content |
String |
64 |
YES |
奖项名称 |
status |
String |
64 |
NO |
状态 |
scorelist数据:
字段名称 |
类型 |
长度 |
是否必填 |
字段说明 |
content |
String |
64 |
YES |
学分名称 |
status |
String |
64 |
NO |
状态 |
1.4. https请求参数示例
https://openapi.5idream.net/score/getBatchGrowthRecords?
openId=20140723000007123&token= 680B3D353FC59D0EA57C96759A63D8FD &sign_type=MD5&sign=680B3D353FC59D0EA57C96759A63D8FD&
info_content={
"studentNo":"10086"
}&md5_salt=010Aed85
1.5. 响应参数示例
{
"code": "100",
"data": "swadfwfsffweswadfwfsffweswadfwfsffweswadfwfsffweswadfwfsffweswadfwfsffweswadfwfsffwe",
"msg": "操作成功",
"success": true
}
1.6. data解密后格式
[{
"identificationCode": "唯一识别编号",
"studentNo": "学号",
"studentName": "学生姓名",
"collegeId": "学院ID",
"collegeName": "学院名称",
"startTime": "开始时间 2017-12-26",
"endTime": "结束时间 2017-12-26",
"categoryName": "一级分类名称",
"typeName": "二级分类名称",
"chanel": "来源,如:活动/部落/补录/个人申请",
"activityId": 331102,
"activityName": "签到测试专用",
"locusContent": "成长记录内容",
"locusLevel": "活动级别 如:院系/校级",
"updateTime": "操作时间 2016-08-30 09:17:26.000002",
"isCancel": "撤销标记 如:正常/已撤销",
"prizelist": [{
"content": "二等奖",
"status": ""
}, {
"content": "一等奖",
"status": ""
}],
"scorelist": [],
"delflag": "删除标记 如:正常/已删除"
},{
"identificationCode": "唯一识别编号",
"studentNo": "学号",
"studentName": "学生姓名",
"collegeId": "学院ID",
"collegeName": "学院名称",
"startTime": "开始时间 2017-12-26",
"endTime": "结束时间 2017-12-26",
"categoryName": "一级分类名称",
"typeName": "二级分类名称",
"chanel": "来源,如:活动/部落/补录/个人申请",
"locusContent": "成长记录内容",
"locusLevel": "活动级别 如:院系/校级",
"updateTime": "操作时间 2016-08-30 09:17:26.000002",
"isCancel": "撤销标记 如:正常/已撤销",
"prizelist": [{
"content": "一等奖",
"status": "已撤回"
}],
"scorelist": [{
"content": "大玮的学分1.00积分",
"status": ""
}],
"delflag": "删除标记 如:正常/已删除"
}]
1.7. 异常响应说明
code编码 |
字段说明 |
9000001 |
接口调用频繁(接口调用频率200毫秒) |