1.4.5.1. 人员设备关系绑定
设备和人员关系绑定之前,需添加设备和同步人员信息。当人员需要下发到设备进行核验操作时调用。
Request:
POST /v1.0/hr/employee/bindDevice
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"params": {
"sns": ["ceshi0002","ceshi0003"],
"employeeNos":["350001","350002"]
}
}
}
参数名 | 类型 | 必填 | 描述 |
---|---|---|---|
sns | String[] | Y | 设备序列号数组,数组长度不超过10 |
employeeNos | String[] | Y | 人员号数组,数组长度不超过100 |
Response:
{
"code": "E0010042",
"mid": "xxxxxxx",
"message": "没有权限操作此设备",
"payload": {
"results": {
"sn": "ceshi0002",
"employeeNo": ""
}
}
}
参数名 | 类型 | 描述 |
---|---|---|
sn | String | 绑定异常的设备序列号,异常情况才返回 |
employeeNo | String | 绑定异常的人员号,异常情况才返回 |
注意事项:
- 本接口在出现异常的情况下才会返回对应的sn或employeeNo信息,并且只返回第一个发生错误的信息。
1.4.5.2. 人员设备关系解绑
删除设备和人员的绑定关系,设备删除该人员。当删除人员在设备上的权限时调用,多用于人员调岗的场景。
Request:
POST /v1.0/hr/employee/unbindDevice
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"params": {
"sns": ["ceshi0002","ceshi0003"],
"employeeNos":["350001","350002"]
}
}
}
参数名 | 类型 | 必填 | 描述 |
---|---|---|---|
sns | String[] | Y | 设备序列号数组,数组长度不超过10 |
employeeNos | String[] | Y | 人人员号数组,数组长度不超过100 |
Response:
{
"code": "E0010042",
"mid": "xxxxxxx",
"message": "没有权限操作此设备",
"payload": {
"results": {
"sn": "ceshi0002",
"employeeNo": ""
}
}
}
参数名 | 类型 | 描述 |
---|---|---|
sn | String | 绑定异常的设备序列号,异常情况才返回 |
employeeNo | String | 绑定异常的人员编号,异常情况才返回 |
注意事项: 本接口在出现异常的情况下才会返回对应的sn或employeeNo信息,并且只返回第一个发生错误的信息。