拉取变更集

接口说明

host	path	method	content-type
open.wecard.qq.com	/cgi-bin/guard/device/pull-config	POST	application/json

请求参数

{
  "access_token": "z8WH...R7Fd",
  "device_no": "MRC00001",
  "version": 3,
  "page": 1,
  "page_size": 20
}

参数	必填	类型	说明
access_token	✔️	string	接口请求凭证
device_no	✔️	string	门禁机具设备号
version	✔️	int	设备保存的通行名单版本号
page		int	分页页数（从 1 开始）
page_size		int	分页每页记录条数

响应参数

{
  "code": 0,
  "message": "",
  "data": {
    "diff": [
      {
        "t": 1,
        "cu": {
          "c": "123456789",
          "p": "7h5g0123",
          "r": ["3tx"]
        }
      },
      {
        "t": 2,
        "cr": {
          "mark": "3tx",
          "configs": [
            {
              "time_ranges": [
                {
                  "start": "00:00:00",
                  "end": "23:59:59"
                }
              ],
              "months": [7, 8],
              "weekdays": [0]
            }
          ]
        }
      },
      {
        "t": 3,
        "du": "abcdefgh",
        "p": "7h5g0124"
      },
      {
        "t": 4,
        "dr": "d1"
      }
    ],
    "open": false,
    "version": 4,
    "page": 1,
    "page_size": 20,
    "total": 4
  }
}

data 中的参数说明

参数	类型	说明
diff	array	新版本的通行名单与设备保存的通行名单的变更集
open	bool	是否开放通行
version	int	新版本的名单规则版本号
page	int	分页页数，根据请求参数确定
page_size	int	分页每页记录条数，根据请求参数确定
total	int	总记录条数

变更集说明

有以下四种不同的变更类型：

通行名单新增/变更

示例：

{
  "t": 1,
  "cu": {
    "c": "123456789",
    "p": "7h5g0123",
    "r": ["3tx"]
  }
}

t值为1，cu即为通行名单全量同步中的单项，见通行名单说明

通行规则新增/变更

示例：

{
  "t": 2,
  "cr": {
    "mark": "3tx",
    "configs": [
      {
        "time_ranges": [
          {
            "start": "00:00:00",
            "end": "23:59:59"
          }
        ],
        "months": [7, 8],
        "weekdays": [0]
      }
    ]
  }
}

t值为2，cr即为通行规则全量同步接口中的单项通行规则，见通行规则说明

通行名单删除

示例：

{
  "t": 3,
  "du": "abcdefgh",
  "p": "7h5g0123"
}

t值为3，du即为通行名单中删除项的电子卡号，p为实体卡号。

通行规则删除

{
  "t": 4,
  "dr": "d1"
}

t值为4，dr即为通行规则中删除项的规则mark。