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

前端接口对接方案
后端接口:
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 时不要显示“保存二维码”按钮
- “分享”按钮可以保留,不依赖二维码是否已生成
[结果]
[期望]