主题
生成访客二维码 3.4.1.Beta1+
接口说明
请求URL:http[s]://{网关地址}/minos-manager/authentication/qrCode/qrCodeVisitor
请求方式: POST
请求内容类型: application/json
响应内容类型: application/json
请求说明
请求体
| 字段名 | 参数名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 用户姓名 | userName | M | String | 用户姓名 |
| 身份二维码中带的code,即用户的uuid | code | M | String | 用于获取苏康码状态 |
| 身份证号码 | certCode | M | String | 身份证号码 |
| 事项权限的代码 | permissionCode | M | String | 真实存在 |
| 开始时间 | startTime | M | String | 格式 yyyy-MM-dd HH:mm:ss |
| 结束时间 | endTime | M | String | 格式 yyyy-MM-dd HH:mm:ss |
请求示例
json
{
"userName":"example",
"code":"998952548292227072",
"certCode":"321002199902012214",
"permissionCode":"A1",
"startTime":"2022-07-17 12:00:00",
"endTime":"2022-09-16 12:00:00"
}1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
响应说明
响应体
| 字段名 | 参数名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 返回码 | errcode | M | String | 返回码,0 成功,其他为错误 |
| 返回码描述 | errmsg | M | Sring | 返回码描述 |
| 返回对象 | data | O | Object | 返回的用户对象,返回数据为map格式 |
响应示例
json
{
"errcode": "0",
"errmsg": "成功",
"data": {
"qrCodeVisitor": "WisQR://2/998952548292227072/LQLU857usdG_WmqQxHhP4PZxdyOJVfi-CI9WyZR-9Bb3esfcWIKNMYBDQAb9bPTtNy949xV-HU-7sEx4-PGeYA==/MEUCIQDanyqEPKo_1lzQWanWSniEyBl4Kp9ywv_HKP0BmapcRgIgH7vwd5WAjEsQRAlGZr3zrGjD4ATWxaPLz6Bl8Gs__Wo=",
"time": "LQLU857usdG_WmqQxHhP4KmiblVRJxztPqaAfut6eq8="
}
}1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
错误码
| 错误码 | 描述 |
|---|---|
| 221002 | 学工号不能为空 |
| 221003 | 事项口令代码不能为空 |
| 221005 | 学工号或事项口令的代码不存在 |
| 221006 | 学工号账号状态异常 |
| 221008 | 口令时间不能为空 |
| 221010 | 口令时间正确格式为yyyy-MM-dd HH:mm:ss |
| 221011 | 口令开始时间应该小于口令结束时间 |
| 221014 | 当前时间不在口令有效时间范围内 |
| 220001 | 系统异常 |
Demo
java
// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
GetQrCodeVisitorRequest request = new GetQrCodeVisitorRequest();
request.setUserName("example");
request.setCode("1267776360420745216");
request.setCertCode("321002199902012214");
request.setPermissionCode("A1");
request.setStartTime("2022-07-20 12:00:00");
request.setEndTime("2025-07-25 12:00:00");
BaseResponse response = client.execute(request);
//调用成功,则处理业务逻辑
if (response.isSuccess()) {
//.....
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

