申请一个二维码用于一系列二维码门禁的通行
路径 | /entrance/paas/perm/qrcode/generate |
版本号 | 1.0.1 |
协议 | HTTPS |
请求方法 | POST |
是否需要用户身份鉴权 | 否 |
超时时间 | 20000 |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
iotIds | List | 是 | ["p2OsgId2N2k******hRCQP000101"] | 待配置权限的门禁设备iotId,最多支持500个设备。 |
identityId | String | 是 | 50acopfd3a94900*****85ed2699e052432c34452 | 待分配二维码权限的人的统一身份ID。 |
expiryTime | String | 是 | 2020-03-04 18:00:00 | 二维码有效期,时间格式 yyyy-MM-dd HH:mm:ss",不能超过生效时间+24小时 |
effectiveTime | String | 否 | 2020-03-04 18:00:00 | 二维码生效期,时间格式 yyyy-MM-dd HH:mm:ss |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | Int |
响应码, 200: 成功 |
|
message | String |
错误消息 |
|
localizedMsg | String |
本地语言错误消息 |
|
data | String |
生成的二维码 |
示例
请求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "1.0.1"
},
"params":{
"iotIds":[
"p2OsgId2N2k******hRCQP000101"
],
"identityId": "50acopfd3a94900*****85ed2699e052432c34452",
"expiryTime": "2020-03-04 18:00:00",
"effectiveTime": "2020-03-04 18:00:00"
}
}
正常返回示例
JSON
格式
{
"id":"4a70179d-47d8-4fdf-9067-8a5eedf63483",
"code": 200,
"message": null,
"localizedMsg": null,
"data":"24D*****D8CD3"
}
异常返回示例
JSON
格式
{
"id":"4a70239d-4cd8-4f2f-9067-4e540df7b5b3",
"code":403,
"message":"request forbidden.",
"localizedMsg":"请求被禁止",
"data":null
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
500 | 500 | Internal Error | Internal Error |
503 | 503 | Service Unavailable | Service Unavailable |
403 | 403 | Request Limited | Request Limited |
401 | 401 | Empty Signature | Empty Signature |
400 | 400 | Request Format Error | Request Format Error |
200 | 20003 | Find Backend Error | Find Backend Error |
200 | 20004 | Backend Service Error | Backend Service Error |
200 | 20055 | Backend Service Invalid | Request Format Error |
200 | 20056 | Hsf Invoke Timeout | Hsf Invoke Timeout |
200 | 401 | Request Authorized Error | Request Authorized Error |
200 | 403 | Request Forbidden | Request Forbidden |
200 | 500 | Server Error | Server Error |
200 | 2459 | oa error message | 会话Id不存在 |
200 | 2459 | oa error message | 会话Id不存在 |
200 | 2401 | refreshToken invalid | refreshToken已经失效 |
200 | 2401 | refreshToken invalid | refreshToken已经失效 |
200 | 460 | identityIds need between 1-50 | 入参错误 |
200 | 460 | identityIds need between 1-50 | 入参错误 |
200 | 460 | identityIds need between 1-50 | 入参错误 |
200 | 460 | identityIds need between 1-50 | 入参错误 |
200 | 403 | request forbidden. | 请求被禁止 |
200 | 2407 | openId invalid | openId invalid |
200 | 403 | request forbidden. | 请求被禁止 |
200 | 2407 | openId invalid | openId invalid |
200 | 403 | request forbidden. | 请求被禁止 |
200 | 2407 | openId invalid | openId invalid |
200 | 403 | request forbidden. | 请求被禁止 |
200 | 403 | request forbidden. | 请求被禁止 |
200 | 2486 | access refresh token expired | accessToken或者 refreshToken已经过期 |
200 | 403 | request forbidden. | 请求被禁止 |
200 | 460 | request parameter error. | 入参不正确 |
200 | 403 | request forbidden | 访问被禁止 |
200 | 460 | dingdingbind employee not exist | 请求参数错误 |
200 | 2442 | employee is not exist | 未找到绑定的员工信息 |
200 | 403 | request forbidden | 访问被禁止 |
200 | 460 | dingdingbind employee not exist | 请求参数错误 |
200 | 2442 | employee is not exist | 未找到绑定的员工信息 |
在文档使用中是否遇到以下问题
更多建议
匿名提交