简要描述

  • 运维人员通过小程序扫码进入对讲授权页面后,调用该接口完成与值班室的绑定。绑定成功后,该运维人员后续即可在小程序中接收对讲通知、进行应答和开门等操作。
  • 绑定凭证 token 由后台在生成扫码二维码时写入,5 分钟内有效,一次性消费。

请求地址

  • POST {服务地址}/api/miniApp/authIntercomBind
  • Content-Type:application/json

请求参数

参数名 是否必填 类型 说明
dutyRoomNo String 值班室编号(二维码 URL 中携带)
adminsId String 运维人员ID(二维码 URL 中携带)
appId String 微信小程序 appId
openId String 微信用户 openId
token String 一次性绑定凭证(二维码 URL 中携带,5 分钟内有效)

请求示例

{
“dutyRoomNo”: “202605120001”,
“adminsId”: “12345”,
“appId”: “wx1234567890abcdef”,
“openId”: “oABCD1234EFGH5678IJKL”,
“token”: “9a8b7c6d5e4f3a2b1c0d9e8f7a6b5c4d”
}

响应参数

名称 类型 参数说明 备注
code int 响应码 1:成功;其他:失败
msg String 响应信息
data Object 响应体信息 本接口固定为 null
timeStamp String 服务端响应时间戳(毫秒)

响应示例

绑定成功(首次扫码)

{
“code”: 1,
“msg”: “绑定成功”,
“data”: null,
“timeStamp”: “1747008000000”
}

已绑定(本人重复扫码,幂等)

{
“code”: 1,
“msg”: “已绑定”,
“data”: null,
“timeStamp”: “1747008000000”
}

失败:值班室编号不能为空

{
“code”: 500,
“msg”: “值班室编号不能为空”,
“data”: null,
“timeStamp”: “1747008000000”
}

失败:运维人员ID不能为空

{
“code”: 500,
“msg”: “运维人员ID不能为空”,
“data”: null,
“timeStamp”: “1747008000000”
}

失败:AppId不能为空

{
“code”: 500,
“msg”: “AppId不能为空”,
“data”: null,
“timeStamp”: “1747008000000”
}

失败:OpenId不能为空

{
“code”: 500,
“msg”: “OpenId不能为空”,
“data”: null,
“timeStamp”: “1747008000000”
}

失败:缺少绑定凭证

{
“code”: 500,
“msg”: “缺少绑定凭证”,
“data”: null,
“timeStamp”: “1747008000000”
}

失败:二维码已过期

{
“code”: 500,
“msg”: “二维码已过期,请联系管理员重新生成”,
“data”: null,
“timeStamp”: “1747008000000”
}

失败:参数非法(token 与请求参数不匹配)

{
“code”: 500,
“msg”: “参数非法”,
“data”: null,
“timeStamp”: “1747008000000”
}

失败:已被其他运维人员绑定

{
“code”: 500,
“msg”: “已被其他运维人员绑定”,
“data”: null,
“timeStamp”: “1747008000000”
}

作者:陈伟勇  创建时间:2026-05-12 14:15
最后编辑:陈伟勇  更新时间:2026-05-12 14:45