2993门禁二维码刷新按钮对接新接口,访客邀请界面优化
重现步骤

[步骤]

业主小程序-访客邀请界面的门禁二维码界面对接新接口,对访客邀请界面进行优化

file-read-8805.png

前端接口对接方案

后端接口:

POST /miniapp/parking/visitor/accessCode/retry/{id}

用途:点击“刷新”时触发门禁码重新生成。

访客详情接口原来继续用:

GET /miniapp/parking/visitor/detail/{id}

详情返回字段里会多这些:

acSyncStatus: number; // 0待生成 1生成中 2已生成 3生成失败

acSyncStatusName: string; // 状态中文

acSyncFailReason: string; // 失败原因

qrCode: string; // 有二维码时返回 base64 图片

前端展示逻辑优化建议:

- qrCode 有值:显示二维码,显示“保存二维码”

- qrCode 无值且 acSyncStatus === 1:显示“门禁码生成中,请稍后刷新”

- qrCode 无值且 acSyncStatus === 3:显示“门禁码生成失败,请点击刷新重试”,下面展示 acSyncFailReason

- qrCode 无值且其他状态:显示“正在等待第三方门禁系统返回数据”

- 点击“刷新”:先调 POST /miniapp/parking/visitor/accessCode/retry/{id},再重新调详情接口刷新页面

- 没有 qrCode 时不要显示“保存二维码”按钮

- “分享”按钮可以保留,不依赖二维码是否已生成

[结果]

[期望]

所属产品
所属模块
所属计划
来源用例
Bug类型
代码错误
严重程度
优先级
1
Bug状态
激活
激活次数
激活时间
是否确认
未确认
指派给
廖艳秀 于 2026-05-27 11:29:53
截止日期
反馈者
通知邮箱
操作系统
浏览器
关键词
抄送给
由谁创建
陈绍文 于 2026-05-27 11:29:53
影响版本
主干
由谁解决
解决版本
解决方案
由谁关闭
最后修改