本组说明
本组覆盖电商完整交易闭环:逛商品(列表/详情/规格)→ 看评论 → 加购物车 → 结算(地址/运费/优惠券)→ 下单 → 去收银台(选支付方式/传支付凭证)→ 查订单/取消/确认收货 → 售后(见《会员接口》的 aftersale 篇)。
包含内容
- 商品
product:列表、详情、规格属性,以及工作端商品维护(product/work); - 规格
attribute:商品规格/属性字典; - 评论
comment:商品评论列表与发表(含图片上传); - 订单
order:唯一入口聚合四个子链路——- 订单主体:我的订单列表、详情、取消、确认收货;
- 购物车
order/cart:数量角标、加购、改数量、删除; - 结算
order/checkout:结算页数据、下单、支付成功页、切换配送方式、用券; - 收银台
order/cashier:支付方式列表、发起支付、上传支付凭证; - 工作端
order/work:订单处理、核销、改价、物流。
使用建议
- 结算链路依赖 Cookie 会话(运费、优惠券暂存于 Session):浏览器端跨域必须
withCredentials: true且服务端开启credentials,详见《客户端约定与扩展字段》; - 购物车与订单接口全部要求登录令牌;
- 下单前建议先调结算页接口(
order/checkout)拿最新金额与配送选项,不要在前端自行计算运费与优惠; - 收银台传"支付凭证"后订单进入人工核验流程(以站点支付配置为准);
- 商品详情中的价格相关字段仅供参考展示,实际以结算页金额为准。