下发口令 3.4.1.Beta1+

接口说明

请求URL：http[s]://{网关地址}/minos-manager/authentication/qrCode/addUserPermission

请求方式： POST

请求内容类型： application/json

响应内容类型： application/json

请求说明

请求体

字段名	参数名	必填	类型	描述
学工号	userId	M	String	学工号真实存在且有效
事项权限的代码	permissionCode	M	String	事项权限的代码
口令开始时间	startTime	M	String	格式：yyyy-MM-dd HH:mm:ss
口令结束时间	endTime	M	String	格式：yyyy-MM-dd HH:mm:ss；

提示

• 在有效期内生成的二维码中会有事项权限的代码对应的口令。

• 口令结束时间不能小于开始时间，不能小于当前时间

请求示例

{
"userId":"testAct",
"permissionCode":"A21",
"startTime":"2022-07-20 12:00:00",
"endTime":"2022-07-25 12:00:00"
}

响应说明

响应体

字段名	参数名	类型	描述
返回码	errcode	M	String
返回码描述	errmsg	M	Sring
返回对象	data	O	Object

errcode 为0即表示下发成功，无返回数据

响应示例

{
    "errcode": "0",
    "errmsg": "成功",
    "data": null
}

错误码

错误码	描述
221002	学工号不能为空
221003	事项口令代码不能为空
221005	学工号或事项口令的代码不存在
221006	学工号账号状态异常
221008	口令时间不能为空
221010	口令时间正确格式为yyyy-MM-dd HH:mm:ss
221011	口令开始时间应该小于口令结束时间
221014	当前时间不在口令有效时间范围内
222002	用户事项口令关系已存在，不需要重复生成
220001	系统异常

Demo

java

// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
AddUserPermissionRequest request = new AddUserPermissionRequest();
request.setUserId("ampadmin");
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()) {
	//.....
}