8.1 分页查询企业勋章列表
# 8.1 分页查询企业勋章列表
# 接口URL
{开放平台域名地址}/openApi/open/medal/list
# HTTP请求方式
POST
# 公共参数
| 字段 | 类型 | 是否必填 | 中文意描述 |
|---|---|---|---|
| appId | String | 是 | 由百福得向客户方发放 |
| timestamp | String | 是 | 毫秒级时间戳 防止重复攻击 |
| sign | String | 是 | 签名 |
| version | String | 否 | 业务接口版本号,如1.0.0 |
# body参数
| 字段 | 类型 | 是否必填 | 中文意描述 |
|---|---|---|---|
| currentPage | Integer | 否 | 页码,默认1 |
| itemsPerPage | Integer | 否 | 页数,默认10 |
| name | String | 否 | 勋章名称 |
| status | Integer | 否 | 状态,0:停用,1:启用 |
# 请求示例
POST /openApi/open/medal/list?appId=abc×tamp=1597300776947&sign=fa66cb4d8604413b8fb30afd32e3e73e HTTP/1.1 Content-Type: application/json Cache-Control: no-cache { "currentPage": 1, "itemsPerPage": 10, "name": "优秀员工", "status": 1 }1
2
3
4
5
6
7
8
9
# 返回参数说明
| 字段 | 类型 | 是否必填 | 中文意描述 |
|---|---|---|---|
| code | String | 返回码 | |
| data | ResponseData | 否 | 相应报文 |
| msg | String | 否 | 如果错误,返回错误信息 |
ResponseData:
| 字段 | 类型 | 中文意描述 |
|---|---|---|
| id | Long | 勋章Id |
| darkPic | String | 未点亮勋章图片url |
| lightPic | String | 点亮勋章图片url |
| medalClassifyId | Integer | 勋章分类id |
| medalClassifyName | String | 勋章分类名称 |
| medalDesc | String | 勋章描述 |
| medalSort | Integer | 勋章排序 |
| medalType | Integer | 勋章类型:1独立勋章 |
| name | String | 勋章名称 |
| status | Integer | 状态,0:停用,1:启用 |
# 返回示例
success:
{
"code": "0",
"data": [
{
"id": 221,
"darkPic": "",
"lightPic": "",
"medalClassifyId": 0,
"medalClassifyName": "NEW_STAFF",
"medalDesc": "",
"medalSort": 0,
"medalType": 1,
"name": "",
"status": 0
},{
"id": 222,
"darkPic": "",
"lightPic": "",
"medalClassifyId": 0,
"medalClassifyName": "NEW_STAFF",
"medalDesc": "",
"medalSort": 0,
"medalType": 1,
"name": "",
"status": 0
}
],
"msg": "success"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
fail:
{
"code": "10016",
"msg": "签名错误"
}
1
2
3
4
2
3
4