1.9.1. 组织设备关系绑定
支持的版本:v1.1.0 +
绑定组织和设备的关系,并绑定该组织下的所有员工到设备。设备和组织关系绑定之前,需添加设备和同步组织信息。
Request:
POST /v1.0/hr/organization/bindDevice
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"params": {
"sns": ["ceshi0002", "ceshi0003"],
"orgCodes": ["org_01", "org_02"]
}
}
}
参数名 | 必填 | 描述 |
---|---|---|
sns | Y | 设备序列号数组 |
orgCodes | Y | 组织架构编码数组 |
Response:
{
"code": "E0010042",
"mid": "xxxxxxx",
"message": "没有权限操作此设备",
"payload": {
"results": {
"sn": "ceshi0002",
"orgCode": ""
}
}
}
参数名 | 描述 |
---|---|
sn | 绑定异常的设备序列号,异常情况才返回 |
orgCode | 绑定异常的组织架构编码,异常情况才返回 |
注意事项:
本接口在出现异常的情况下才会返回对应的sn或orgCode信息,并且只返回第一个发生错误的信息。
1.9.2. 组织设备关系解绑
支持的版本:v1.1.0 +
删除设备和组织的绑定关系,并删除该组织下所有员工与设备的绑定关系。
Request:
POST /v1.0/hr/organization/unbindDevice
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"params": {
"sns": ["ceshi0002", "ceshi0003"],
"orgCodes": ["org_01", "org_02"]
}
}
}
参数名 | 必填 | 描述 |
---|---|---|
sns | Y | 设备序列号数组 |
orgCodes | Y | 组织架构编码数组 |
Response:
{
"code": "E0010042",
"mid": "xxxxxxx",
"message": "没有权限操作此设备",
"payload": {
"results": {
"sn": "ceshi0002",
"orgCode": ""
}
}
}
参数名 | 描述 |
---|---|
sn | 解绑异常的设备序列号,异常情况才返回 |
orgCode | 解绑异常的组织架构编码,异常情况才返回 |
注意事项:
本接口在出现异常的情况下才会返回对应的sn或orgCode信息,并且只返回第一个发生错误的信息。
1.9.3. 人员设备关系绑定
支持的版本:v1.1.0 +
设备和人员关系绑定之前,需添加设备和同步员工信息。
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 | Y | 设备序列号数组 |
employeeNos | Y | 员工工号数组,数组长度不超过100 |
Response:
{
"code": "E0010042",
"mid": "xxxxxxx",
"message": "没有权限操作此设备",
"payload": {
"results": {
"sn": "ceshi0002",
"employeeNo": ""
}
}
}
参数名 | 描述 |
---|---|
sn | 绑定异常的设备序列号,异常情况才返回 |
employeeNo | 绑定异常的员工工号,异常情况才返回 |
注意事项:
本接口在出现异常的情况下才会返回对应的sn或employeeNo信息,并且只返回第一个发生错误的信息。
1.9.4. 人员设备关系解绑
支持的版本:v1.1.0 +
删除设备和人员的绑定关系,设备删除该人员。
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 | Y | 设备序列号数组 |
employeeNos | Y | 员工工号数组,数组长度不超过100 |
Response:
{
"code": "E0010042",
"mid": "xxxxxxx",
"message": "没有权限操作此设备",
"payload": {
"results": {
"sn": "ceshi0002",
"employeeNo": ""
}
}
}
参数名 | 描述 |
---|---|
sn | 解绑异常的设备序列号,异常情况才返回 |
employeeNo | 解绑异常的员工工号,异常情况才返回 |
注意事项:
本接口在出现异常的情况下才会返回对应的sn或employeeNo信息,并且只返回第一个发生错误的信息。