# 积分相关接口API
注意事项
- 所有API接口的域名前缀:http://gateway--cnki--net--https.cnki.mdjsf.utuvpn.utuedu.com:9000/openx/
- 所有接口未显性指明申请
JWT
的方式,统一为用户名+密码
的方式- 所有接口统一认证方式:Header请求头中添加
Authorization
字段,值为"Bearer "
+JWT
# 根据用户id获取用户当前总积分
接口地址 /ismsapi/api/account/point/{userId}
请求方式 GET
接口描述 根据用户id获取用户当前总积分
请求参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
userId | 客户端id | query | true | String |
响应状态
状态码 | 说明 | schema |
---|---|---|
200 | OK | |
400300 | 权限不足,拒绝访问! | |
400301 | 账号失效! |
响应参数
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | 响应编码 | integer | |
success | 请求是否成功 | boolean | |
content | 响应数据 | Integer | |
message | 提示消息 | string | |
count | 数据条数 | Integer | |
total | 数据总条数 | Integer |
响应示例
{
"success": true,
"message": "",
"content": 1206,
"count": 0,
"total": 0,
"code": null
}
# 根据用户id获取用户当天积分详情
接口地址 /ismsapi/api/account/points/{userId}/day
请求方式 GET
接口描述 根据用户id获取用户当天积分详情
请求参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
userId | 客户端id | query | true | String |
响应状态
状态码 | 说明 | schema |
---|---|---|
200 | OK | |
400430 | 权限不足,拒绝访问! | |
400301 | 账号失效! |
响应参数
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | 响应编码 | integer | |
success | 请求是否成功 | boolean | |
content | 响应数据 | PointInfos | PointInfos |
message | 提示消息 | string | |
count | 数据条数 | Integer | |
total | 数据总条数 | Integer |
schema属性说明
PointInfos
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
Daily2 | APP首次登陆类 | PointInfo | PointInfo |
Daily | 每日学习奖励类 | PointInfo | PointInfo |
Activity | 平台活动奖励类 | PointInfo | PointInfo |
ECSP | 其它类 | PointInfo | PointInfo |
schema属性说明
PointInfo
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
ID | 积分id | String | |
RuleName | 规则名称 | String | |
Description | 规则描述 | String | |
dayPoint | 当日积分 | Integer |
响应示例
{
"success": true,
"message": "",
"content": {
"Daily2": [
{
"ID": "12a80b4c-6a4a-4978-8b61-ad56ad502044",
"RuleName": "app登录额外",
"PointIdentityName": "APPFirstLogin",
"SourcePlatform": "",
"Point": 3,
"MaxPoint": 3,
"UserMaxPoint": 3,
"StaticsPoint": true,
"StaticsContribution": true,
"Description": "app端每日首次登录额外奖励",
"Sequence": 0,
"OperUrl": null,
"Order": 0,
"PlatFlag": "Daily2",
"OperUrlName": "",
"ImagePath": "",
"Isuse": true,
"dayPoint": 3
}
],
"Activity": [
{
"ID": "c93f5e8d-f3d6-46b7-943e-a907c7112129",
"RuleName": "提交问卷日志",
"PointIdentityName": "PostQuestion_XMRD",
"SourcePlatform": "CRSP_BASIC_SALE",
"Point": 200,
"MaxPoint": 200,
"UserMaxPoint": 200,
"StaticsPoint": true,
"StaticsContribution": true,
"Description": "提交问卷日志",
"Sequence": 0,
"OperUrl": "",
"Order": 15,
"PlatFlag": "Activity",
"OperUrlName": "去提交",
"ImagePath": "15",
"Isuse": true,
"dayPoint": 0
},
{
"ID": "d9b9ecfc-c9e7-4ddf-ae56-c35c711588df",
"RuleName": "提交问卷日志",
"PointIdentityName": "PostQuestion_POS",
"SourcePlatform": "CRSP_BASIC_SALE",
"Point": 30,
"MaxPoint": 30,
"UserMaxPoint": 30,
"StaticsPoint": true,
"StaticsContribution": true,
"Description": "提交问卷日志",
"Sequence": 0,
"OperUrl": "",
"Order": 15,
"PlatFlag": "Activity",
"OperUrlName": "去提交",
"ImagePath": "15",
"Isuse": true,
"dayPoint": 0
}
],
"ECSP": [
{
"ID": "1205669F-51F8-11E9-918C-94C6919000B8",
"RuleName": "意见被采纳",
"PointIdentityName": "FeedbackAdopted",
"SourcePlatform": "CRSP_BASIC_PSMC",
"Point": 10,
"MaxPoint": 10000,
"UserMaxPoint": -1,
"StaticsPoint": true,
"StaticsContribution": true,
"Description": "意见反馈被采纳",
"Sequence": 0,
"OperUrl": "",
"Order": 12,
"PlatFlag": "ECSP",
"OperUrlName": "",
"ImagePath": "",
"Isuse": true,
"dayPoint": 0
}
],
"Daily": [
{
"ID": "5fb52b25bd784048b7c56b90d94deb9d",
"RuleName": "资源包领取",
"PointIdentityName": "XmrdBuy",
"SourcePlatform": "CRSP_MEMBER",
"Point": 1,
"MaxPoint": 5,
"UserMaxPoint": 5,
"StaticsPoint": true,
"StaticsContribution": true,
"Description": "每领取一个资源包",
"Sequence": 0,
"OperUrl": "",
"Order": 12,
"PlatFlag": "Daily",
"OperUrlName": "",
"ImagePath": "17",
"Isuse": true,
"dayPoint": 0
}
],
"Daily-d": [
{
"ID": "8CF4F096-51F7-11E9-918C-94C6919000B8",
"RuleName": "阅读时长",
"PointIdentityName": "ReadingTime",
"SourcePlatform": "read",
"Point": 3,
"MaxPoint": 10000,
"UserMaxPoint": 18,
"StaticsPoint": true,
"StaticsContribution": true,
"Description": "有效阅读时长每累计满6分钟",
"Sequence": 0,
"OperUrl": "",
"Order": 3,
"PlatFlag": "Daily-d",
"OperUrlName": "去阅读",
"ImagePath": "3",
"Isuse": false,
"dayPoint": 0
}
]
},
"count": 5,
"total": 13,
"code": null
}
# 根据用户id获取用户积分历史
接口地址 /ismsapi/api/account/points/history
请求方式 GET
接口描述 根据用户id获取用户当天积分详情
请求参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
userId | 客户端id | query | true | String | |
pageIndex | 分页页码 | query | true | Integer | |
pageSize | 分页条数 | query | false | Integer |
响应状态
状态码 | 说明 | schema |
---|---|---|
200 | OK | |
400430 | 权限不足,拒绝访问! | |
400301 | 账号失效! |
响应参数
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | 响应编码 | integer | |
success | 请求是否成功 | boolean | |
content | 响应数据 | PointHistoryInfo | PointHistoryInfo |
message | 提示消息 | string | |
count | 数据条数 | Integer | |
total | 数据总条数 | Integer |
schema属性说明
PointHistoryInfo
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
OperateTime | 积分记录时间 | String | |
RuleName | 积分规则名称 | String | |
point | 积分值 | Integer |
响应示例
{
"success": true,
"message": "",
"content": [
{
"OperateTime": "2024.04.08 08:53:43",
"RuleName": "app登录额外",
"point": 3
},
{
"OperateTime": "2024.04.08 08:53:43",
"RuleName": "登录",
"point": 10
},
{
"OperateTime": "2024.04.07 09:14:24",
"RuleName": "登录",
"point": 10
},
{
"OperateTime": "2024.04.02 10:32:58",
"RuleName": "登录",
"point": 10
},
{
"OperateTime": "2024.04.01 14:00:41",
"RuleName": "登录",
"point": 10
},
{
"OperateTime": "2024.03.28 09:38:26",
"RuleName": "登录",
"point": 10
},
{
"OperateTime": "2024.03.27 11:28:42",
"RuleName": "登录",
"point": 10
},
{
"OperateTime": "2024.03.26 15:11:37",
"RuleName": "登录",
"point": 10
},
{
"OperateTime": "2024.03.25 15:39:12",
"RuleName": "登录",
"point": 10
},
{
"OperateTime": "2024.03.20 13:51:58",
"RuleName": "登录",
"point": 10
},
{
"OperateTime": "2024.03.18 11:16:24",
"RuleName": "登录",
"point": 10
},
{
"OperateTime": "2024.03.15 09:46:58",
"RuleName": "登录",
"point": 10
},
{
"OperateTime": "2024.03.14 10:19:24",
"RuleName": "登录",
"point": 10
},
{
"OperateTime": "2024.03.13 14:07:32",
"RuleName": "资源包领取",
"point": 1
},
{
"OperateTime": "2024.03.13 02:41:05",
"RuleName": "登录",
"point": 10
},
{
"OperateTime": "2024.03.12 14:57:55",
"RuleName": "登录",
"point": 10
},
{
"OperateTime": "2024.03.11 10:09:56",
"RuleName": "登录",
"point": 10
},
{
"OperateTime": "2024.03.08 09:06:24",
"RuleName": "登录",
"point": 10
},
{
"OperateTime": "2024.03.07 08:33:25",
"RuleName": "登录",
"point": 10
},
{
"OperateTime": "2024.03.06 10:56:48",
"RuleName": "登录",
"point": 10
}
],
"count": 20,
"total": 20,
"code": null
}