简要描述
- 运维人员通过小程序扫码进入对讲授权页面后,调用该接口完成与值班室的绑定。绑定成功后,该运维人员后续即可在小程序中接收对讲通知、进行应答和开门等操作。
- 绑定凭证 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:45