Appearance
订单详情接口
概述
用于查询订单详情、二维码、物流信息以及当前可执行操作。
基本信息
| 项目 | 内容 |
|---|---|
| 接口名称 | 订单详情 |
| 接口用途 | 查询订单详情、二维码、物流和可执行操作 |
| 调用方 | 小程序前端 |
| 请求方式 | GET |
| 请求路径 | /orders/{orderId} |
| 请求头要求 | Authorization |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
orderId | path string | 是 | 订单 ID |
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
order | object | 订单主体 |
writeoffInfo | object | 核销信息 |
logisticsInfo | object | 物流信息 |
actionList | array | 当前可执行按钮 |
成功示例
{"code":"0","message":"ok","data":{"order":{"orderId":"o_1","orderStatus":"pending_writeoff"},"writeoffInfo":{"codeNo":"WX123"},"actionList":["pay","service"]}}
失败示例
错误码
| 错误码 | 说明 |
|---|---|
A0001 | 见系统错误码定义 |
A0002 | 无权限查看该订单 |
接口约束
| 项目 | 说明 |
|---|---|
| 幂等要求 | 否 |
| 前后端同步规则 | 订单状态变化后客户端回源刷新 |
| 缓存/刷新策略 | 不缓存 |
| 一致性要求 | 强一致 |
说明
- 该接口需携带
Authorization请求头进行鉴权。 - 客户端在订单状态变化后应主动回源刷新,避免使用本地缓存数据。
- 接口要求强一致性,不采用缓存策略。
