1.4.7.4.1. 更新门禁权限组
更新门禁权限组，若存在该门禁组则更新，不存在则新增。该接口在设置门禁权限组时调用。
Request:
POST /v1.0/device/permissionGroup/update
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"params": {
"groupNum": 1,
"timezoneNum": 1,
"startTime": "2020-01-01T00:00:00+08:00",
"endTime": "2020-12-31T23:59:00+08:00"
}
}
}
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| groupNum | Integer | Y | 门禁权限组编号,企业内唯一 |
| timezoneNum | Integer | Y | 门禁权限组关联时间段编号，参考更新门禁时间段相关说明 |
| startTime | String | N | 权限组有效时间，默认及时生效，即当前时间，时间格式为ISO8601 |
| endTime | String | N | 权限组有效时间，默认永久，时间格式为ISO8601 |
Response：
{
"code": "00000000",
"mid": "xxx",
"message": "success"
}
1.4.7.4.2. 删除门禁权限组
Request:
POST /v1.0/device/permissionGroup/delete
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"params": {
"groupNum": 1
}
}
}
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| groupNum | Integer | Y | 门禁权限组编号,企业内唯一 |
Response：
{
"code": "00000000",
"mid": "xxx",
"message": "success"
}
1.4.7.4.3. 门禁权限组分配门
指定 “权限组”与“门”的关联关系，若权限组已分配人，则将人员信息下发至门所在的设备。
Request:
POST /v1.0/device/permissionGroup/addDoor
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"params": {
"groupNum": 1,
"devices": [{
"sn": "xxxxxx",
"doorNums": [1, 2, 3, 4]
}]
}
}
}
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| groupNum | Integer | Y | 门禁权限组编号,企业内唯一 |
| devices | Object[] | Y | 设备信息列表，数组长度不超过10 |
| sn | String | Y | 设备序列号 |
| doorNums | Integer[] | N | 门编号列表，当设备为单门控制时此参数可为空，比如一体机，为空时认定门编号为1 |
注： 门编号应在门初始化推送后，查询门信息获得。若传入的门编号不是存在的门，则不做处理，但接口仍会返回成功
Response：
{
"code": "00000000",
"mid": "xxx",
"message": "success"
}
1.4.7.4.4. 门禁权限组移除门
Request:
POST /v1.0/device/permissionGroup/removeDoor
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"params": {
"groupNum": 1,
"sn": "xxxxxx",
"doorNums": [1,2,3,4]
}
}
}
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| groupNum | Integer | Y | 门禁权限组编号,企业内唯一 |
| sn | String | Y | 设备序列号 |
| doorNums | Integer[] | N | 门编号列表，当设备为单门控制时此参数可为空，比如一体机，为空时认定门编号为1 |
Response：
{
"code": "00000000",
"mid": "xxx",
"message": "success"
}
1.4.7.4.5. 门禁权限组分配人
指定 “权限组”与“人”的关联关系，若权限组已分配门，则将人员信息下发至 门所在的设备。
Request:
POST /v1.0/device/permissionGroup/addEmp
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"params": {
"groupNum": 1,
"employeeNos": ["BH89757","BH89758"]
}
}
}
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| groupNum | Integer | Y | 门禁权限组编号,企业内唯一 |
| employeeNos | String[] | Y | 员工工号列表，数组长度不超过100 |
Response：
{
"code": "00000000",
"mid": "xxx",
"message": "success"
}
1.4.7.4.6. 门禁权限组移除人
Request:
POST /v1.0/device/permissionGroup/removeEmp
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"params": {
"groupNum": 1,
"employeeNos": ["BH89757","BH89758"]
}
}
}
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| groupNum | Integer | Y | 门禁权限组编号,企业内唯一 |
| employeeNos | String[] | Y | 员工工号列表，数组长度不超过100 |
Response：
{
"code": "00000000",
"mid": "xxx",
"message": "success"
}
1.4.7.4.7. 门禁权限组移除所有人
Request:
POST /v1.0/device/permissionGroup/removeAllEmp
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"params": {
"groupNum": 1
}
}
}
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| groupNum | Integer | Y | 门禁权限组编号,企业内唯一 |
Response：
{
"code": "00000000",
"mid": "xxx",
"message": "success"
}