客服售后入口接口

概述

用于获取指定订单对应的客服联系方式与引导信息，供小程序前端展示客服售后入口。

基本信息

• 接口名称：客服售后入口
• 接口用途：获取订单对应的客服联系方式与引导信息
• 调用方：小程序前端
• 请求方式：GET
• 请求路径：/orders/{orderId}/service-entry
• 请求头要求：Authorization
• 幂等要求：否
• 缓存/刷新策略：不缓存
• 一致性要求：强一致

请求参数

参数	类型	必填	说明
orderId	path string	是	订单 ID

返回参数

参数	类型	说明
serviceName	string	客服名称
serviceQrCode	string	企业微信二维码
serviceHours	string	服务时间
serviceTips	string	联系说明

成功示例

{"code":"0","message":"ok","data":{"serviceName":"灵妙儿官方客服","serviceQrCode":"https://cdn.example.com/qrcode.png","serviceHours":"09:00-18:00","serviceTips":"请保存二维码后通过企业微信联系客服，备注订单号"}}

失败示例

错误码

• A0001
• A0002
• B1010
• B1011

前后端同步规则

• 打开客服入口不变更订单状态。
• 退款或异常处理结果由后台人工处理后回写订单与系统消息。

实现要点

• 接口返回内容以客服联系方式和引导文案为主，不涉及订单状态修改。
• 由于采用不缓存策略，前端每次进入客服售后入口时应实时请求接口。
• 接口要求强一致，需确保返回的客服信息为当前有效数据。