1. 设置道闸参数

请求说明:

协议 方法 PATH
HTTPS POST /openApi/gateway/getGateStatus

Body参数:

参数 类型 必填 说明
appId String 是 appId
expires String 是 过期时间
sign String 是 签名
deviceNo String 是 设备编号
cmd String 是 固定值:barrierGatewayGetGateStatus
data String 否 无业务参数,传空串 ""
{
  "appId": "ym1a2b3c4d5e6f7g8",
  "expires": "1761004215",
  "sign": "9f2c1d8a7b6e5f4a3c2b1d0e9f8a7b6c",
  "deviceNo": "CM53A1B2C3D4",
  "cmd": "barrierGatewayGetGateStatus",
  "data": ""
}

返回参数:

参数 类型 必填 说明
code int 是 响应状态码
msg String 是 响应消息
appId String 是 appId
expires String 是 过期时间
sign String 签名
deviceNo String 是 设备编号
cmd String 是 固定值:barrierGatewayGetGateStatus
data String 是

平台返回第三方

data 为 JSON 字符串,内容即设备 data:

{
  "code": 200,
  "msg": "操作成功",
  "appId": "ym1a2b3c4d5e6f7g8",
  "expires": "1761004215",
  "sign": "9f2c1d8a7b6e5f4a3c2b1d0e9f8a7b6c",
  "deviceNo": "CM53A1B2C3D4",
  "cmd": "barrierGatewayGetGateStatus",
  "data": "{\"controlVersion\":\"GT_QJ_A7E6\",\"statusRs485\":1,\"statusGateCtrl\":1,\"statusGateDsp\":\"关到位\",\"statusIo\":0}"
}

2 data 字段完整说明

字段 类型 必返 说明 取值
controlVersion String 是 道闸控制板厂家型号标识,决定道闸参数号集合 GT_QJ_A7E6(齐家)、GT_WJ_A7E6(威捷)、GT_ZMT_AA55(志美);扩展型号见 4.3
statusRs485 Integer 是 485 状态:网关与道闸控制板的 485 通讯 1:通讯正常;其他(通常 0):通讯断开
statusGateCtrl Integer 是 道闸状态(数值):闸杆当前位置 0:未知;1:关到位;2:开到位;3:中间位置
statusGateDsp String 是 道闸状态(文本):控制板返回的状态描述,平台界面直接展示 如 关到位、开到位、运行中;无内容时为空串
statusIo Integer 是 防砸地感:地感 / 雷达输入状态 1:地感有车(禁止关闸);0:地感无车

命名约定:statusRs485、statusGateCtrl、statusGateDsp、statusIo 是平台历史道闸协议沿用的字段名,
不要改写成 gate_connect_status 之类的下划线形式,否则 PC 端状态弹窗与第三方都无法解析。
statusGateDsp 平台会做 trim() 处理,前后空格无影响。

4.3 controlVersion 与道闸参数型号对应

controlVersion 厂家 道闸参数号集合 说明
GT_QJ_A7E6 齐家 P04、P05P08、P11P14、P21、P23、F01、F02、F19、F21~F23、F26、F31 直杆道闸(19 个参数号)
GT_WJ_A7E6 威捷 F00~F10、F15、H03、H07、H09 直杆道闸(15 个参数号)
GT_ZMT_AA55 志美 P00P09、P13P16、P32、P33、P60 通道闸 / 栅栏道闸(17 个参数号)
作者:吴勇  创建时间:2026-10-24 15:54
最后编辑:吴勇  更新时间:2026-10-24 16:18