Appearance
客服配置接口
概述
用于获取客服二维码与服务时间，供小程序前端进入客服页时展示使用。
基本信息
| 项目 | 内容 |
|---|---|
| 接口名称 | 客服配置 |
| 接口用途 | 获取客服二维码与服务时间 |
| 调用方 | 小程序前端 |
| 请求方式 | GET |
| 请求路径 | /service/contact |
| 请求头要求 | 无 |
| 幂等要求 | 否 |
| 一致性要求 | 最终一致 |
请求参数
该接口无请求参数。
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| serviceName | string | 客服名称 |
| serviceQrCode | string | 客服二维码 |
| serviceHours | string | 服务时间 |
返回示例
成功示例
{"code":"0","message":"ok","data":{"serviceName":"灵妙儿客服","serviceQrCode":"https://img.example/qrcode.png","serviceHours":"09:00-18:00"}}
失败示例
错误码
| 错误码 | 说明 |
|---|---|
| A0004 | 联系客服信息加载失败，请稍后再试 |
前后端协作规则
- 进入客服页时需回源请求，确保二维码为最新版本。
- 接口数据可缓存 1 小时。
- 数据一致性要求为最终一致。
实现说明
- 该接口主要用于客服页初始化展示。
- 前端应优先在进入页面时拉取最新数据，同时结合 1 小时缓存策略降低重复请求。
- 当接口返回失败时，应向用户展示错误提示，并支持稍后重试。