Appearance
商品详情接口
基本信息
- 接口名称：商品详情
- 接口用途：获取商品详情与实时库存
- 调用方：小程序前端
- 请求方式：
GET - 请求路径：
/goods/{goodsId} - 请求头要求：无
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| goodsId | path string | 是 | 商品 ID |
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| goods | object | 商品详情 |
| store | object | 门店信息 |
| stock | int | 实时库存 |
成功响应示例
{"code":"0","message":"ok","data":{"goods":{"goodsId":"g_1","title":"西湖明信片"},"store":{"storeName":"西湖文创店"},"stock":20}}
失败响应示例
错误码
| 错误码 | 说明 |
|---|---|
| B1001 | 商品不存在或已下架 |
接口规则
- 幂等要求：否
- 前后端同步规则：详情页和下单页都必须回源获取
- 缓存/刷新策略：不缓存库存
- 一致性要求：强一致
说明
该接口用于商品详情页展示及下单前库存确认。由于库存要求强一致，前端在详情页和下单页均需实时回源调用，不得对库存进行本地缓存。