1. 增量查询学分信息
1.1. 协议
- REST-URL:
/score/getBatchScores
- REST-HTTP-Method:
POST
- COUTENT-TYPE:
application/x-www-form-urlencoded; charset=UTF-8
1.2. 请求参数
公共参数： 点击查看
业务参数:
| 字段名称 |
类型 |
长度 |
是否必填 |
字段说明 |
| studentNo |
String |
64 |
NO |
学生学号(不填写则按时间返回所有学生学分信息) |
| tradeTypeId |
String |
64 |
NO |
学分类型id(不填写则按时间返回所有学分类型信息) |
| updateTime |
String |
64 |
NO |
更新标识(非时间格式，用普通字符串格式字段来存储)，2021-08-12 12:05:03.291376_12349，增量查询使用，第一次查询不需要填写，接口返回的数据是按照updateTime升序排列，第二次之后依次使用上一次查询时接口返回数据的最后一条数据的updateTime字段，作为下一次调用接口的参数传回，依次循环即可获取所有的数据。 |
1.3. 响应参数
| 字段名称 |
类型 |
字段说明 |
| data |
String |
如果有数据返回内容 |
| success |
Boolean |
请求处理结果状态 |
| msg |
String |
接口调用结果提示信息 |
| code |
String |
状态码 |
data 数据:
| 字段名称 |
类型 |
长度 |
是否必填 |
字段说明 |
| total |
long |
64 |
YES |
总数据量 |
| list |
List |
|
YES |
学分信息 |
list 数据:
| 字段名称 |
类型 |
长度 |
是否必填 |
字段说明 |
| identificationCode |
String |
32 |
YES |
唯一识别码，可用接口调用方避免重复。根据该字段判断本地是否已经存在该条记录，如存在做更新操作。 |
| schoolId |
String |
32 |
YES |
学校id |
| schoolName |
String |
32 |
YES |
学校名称 |
| collegeId |
String |
32 |
YES |
学院id |
| collegeName |
String |
128 |
YES |
学院名称 |
| classNo |
String |
16 |
YES |
班级 如：2018 |
| studentNo |
String |
32 |
YES |
学号 |
| studentName |
String |
32 |
YES |
学生姓名 |
| createDate |
String |
32 |
YES |
获取时间 如：2019-03-27 11:01:26 |
| createName |
String |
32 |
YES |
发送人 |
| joinDate |
String |
32 |
YES |
年级 如：2018 |
| joinStartDate |
String |
32 |
YES |
参与开始时间 如：2018-08-12 |
| joinEndDate |
String |
32 |
YES |
参与结束时间 如：2018-08-12 |
| categoryId |
String |
32 |
YES |
一级分类id |
| categoryName |
String |
32 |
YES |
一级分类名称 |
| typeName |
String |
32 |
YES |
二级分类名称 |
| typeId |
String |
32 |
YES |
二级分类id |
| num |
String |
32 |
YES |
学分数量 如：0.02 |
| reason |
String |
32 |
YES |
获取原因 |
| scoreId |
String |
32 |
YES |
学分类型id |
| scoreName |
String |
32 |
YES |
学分类型 |
| tradeStatus |
String |
32 |
YES |
发放状态 如：成功/退回 |
| unitName |
String |
32 |
YES |
单位 如：学分/学时 |
| updateTime |
String |
32 |
YES |
2021-08-12 12:05:03.291376_12349,更新标识(非时间格式，用普通字符串格式字段来存储)，作为批量获取数据接口的增量查询使用 |
| activityId |
String |
32 |
NO |
活动id |
| activityName |
String |
32 |
NO |
活动名称 |
| activityLevel |
String |
32 |
NO |
活动级别：院级、校级、市级、省级、国家级 |
| channel |
String |
32 |
YES |
来源：活动、部落、补录、申请 |
| delflag |
String |
32 |
YES |
是否已经删除：正常、已删除 |
1.4. https请求参数示例
https://openapi.5idream.net/score/getBatchScores?
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解密后格式
[{
"schoolId": "学校id",
"schoolName": "学校名称",
"collegeId": "学院id",
"collegeName": "学院名称",
"classNo": "班级 如：2018",
"studentNo": "学号",
"studentName": "学生姓名",
"createDate": "获取时间 如：2019-03-27 11:01:26",
"createName": "发送人",
"identificationCode": "唯一识别码",
"joinDate": "年级 如：2018",
"joinEndDate": "2017-12-26",
"joinStartDate": "2017-12-26",
"categoryId": "一级分类id",
"typeId": "二级分类id",
"categoryName": "一级分类名称",
"typeName": "二级分类名称",
"num": "学分数量 如：0.02",
"reason": "获取原因",
"scoreId": "学分类型id",
"scoreName": "学分类型",
"tradeStatus": "发放状态 如：成功/退回",
"unitName": "单位 如：学分/学时",
"activityId":null,
"activityLevel":null,
"activityName":null,
"channel":"补录",
"delflag":"正常",
"updateTime": "2018-08-12 12:05:03.291376 时间，增量查询使用"
},{
"categoryId": 5429,
"categoryName": "技能特长",
"classNo": "英语1551",
"collegeId": "310",
"collegeName": "梦想剧场",
"createDate": "2018-09-29 10:07:54",
"createName": "sea",
"identificationCode": "291463",
"joinDate": "2018",
"joinEndDate": "2018-09-29",
"joinStartDate": "2018-09-29",
"num": "1.00",
"reason": "取消报名",
"schoolId": "19",
"schoolName": "到梦大学",
"scoreId": 311,
"scoreName": "表演课",
"studentName": "sea",
"studentNo": "185181",
"tradeStatus": "成功",
"typeId": 5430,
"typeName": "技能特长",
"unitName": "积分",
"activityId":101,
"activityLevel":"校级",
"activityName":"活动名称",
"channel":"活动",
"delflag":"正常",
"updateTime": "2018-09-29 10:07:54.291463"
}]
1.7. 异常响应说明
| code编码 |
字段说明 |
| 9000001 |
接口调用频繁 |