shop order - shileishmily/YytRPC GitHub Wiki
1. 全部订单
接口地址:/order/all
接口交互:GET
接口描述:全部订单
header入参
| Parameter | Sample value | Optional | Description |
|---|---|---|---|
| ak | 0130000 | M | 版本号 |
| sessionid | 20161110124538 | M | 会话ID |
| userid | 66666 | M | 用户id |
query入参
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| type | int | 订单类型 | 1-待付款；2-待评价；3-待收货；9-全部订单 |
响应
| Parameter | 描述 | 例子 |
|---|---|---|
| status | string | 0000：成功 |
| message | string | 提示 |
| result | jsonarray | 订单数组 |
result数据结构
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| orderId | string | 订单ID | |
| orderDate | string | 订单日期 | |
| sellerId | int | 商家ID | |
| sellerName | string | 商家名称 | |
| orderStatus | int | 订单状态 | 1-等待买家付款；2-买家已付款；3-卖家已发货；4-派送中；5-已签收；6-交易成功；7-交易关闭 |
| isRate | int | 买家是否已评价 | 1-是；0-否 |
| payType | int | 支付方式 | 支付宝，微信 |
| totalNum | int | 共几件商品 | 3 |
| totalPrice | double | 总计金额（单位：元） | |
| productList | jsonarray | 商品列表 | 一个订单至少包含一个商品 |
productList数据结构
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| goodsId | string | 商品ID | |
| goodsImg | string | 商品图片地址 | |
| goodsTitle | string | 商品标题 | |
| price | double | 价格（单位：元） | |
| costPrice | double | 原价（单位：元） | 23.5 |
| unit | string | 计价单位 | 例如：盒、箱、桶 |
| rebate | double | 折扣 | 7.0（7折） |
| model | string | 型号 | POP-E黄 |
| spec | string | 规格 | 12罐/箱 |
| buyNum | int | 该商品购买数量 | 2 |
2. 下单接口
接口地址:/order/makeOrder
接口交互:POST
接口描述:下单接口，客户端将商家和商品信息传到服务器，服务器根据商家进行分组，生成多笔订单。
header入参
| Parameter | Sample value | Optional | Description |
|---|---|---|---|
| ak | 0130000 | M | 版本号 |
| sessionid | 20161110124538 | M | 会话ID |
| userid | 66666 | M | 用户id |
form入参
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| data | jsonobject | 支付购买的商品列表 | |
| addressId | int | 收件地址ID | |
| receipt | string | 发票信息 |
data数据结构
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| sellerId | int | 商家ID | |
| sellerName | string | 商家名称 | |
| leaveMsg | string | 给卖家留言内容 | |
| storeCouponId | int | 店铺优惠券ID | |
| postType | int | 配送方式 | |
| productList | jsonarray | 商品列表 | 一个订单至少包含一个商品 |
productList数据结构
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| goodsId | string | 商品ID | |
| model | string | 型号 | POP-E黄 |
| spec | string | 规格 | 12罐/箱 |
| buyNum | int | 该商品购买数量 | 2 |
| price | double | 价格（单位：元） | |
| costPrice | double | 原价（单位：元） | 23.5 |
| goodsCouponId | int | 商品优惠券ID | 2 |
响应
| Parameter | 描述 | 例子 |
|---|---|---|
| status | string | 0000：成功 |
| message | string | 提示 |
3. 付款接口
接口地址:/order/payOrder
接口交互:POST
接口描述:付款接口,从服务端获取三方支付需要的数据，实际上该接口为查询操作
header入参
| Parameter | Sample value | Optional | Description |
|---|---|---|---|
| ak | 0130000 | M | 版本号 |
| sessionid | 20161110124538 | M | 会话ID |
| userid | 66666 | M | 用户id |
form入参
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| orderId | string | 订单ID | 1 |
响应
| Parameter | 描述 | 例子 |
|---|---|---|
| status | string | 0000：成功 |
| message | string | 提示 |
| orderId | string | 订单ID |
| result | string | 支付签名数据 |
4. 评价接口
接口地址:/order/rate
接口交互:POST
接口描述:评价接口
header入参
| Parameter | Sample value | Optional | Description |
|---|---|---|---|
| ak | 0130000 | M | 版本号 |
| sessionid | 20161110124538 | M | 会话ID |
| userid | 66666 | M | 用户id |
form入参
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| orderId | string | 订单ID | 1 |
| goodsId | string | 商品ID | 1 |
| score | int | 评分 | 5 |
| content | string | 感受 | 商品很好 |
| img | string | 晒图 | 可以上传多张图片 |
响应
| Parameter | 描述 | 例子 |
|---|---|---|
| status | string | 0000：成功 |
| message | string | 提示 |
5. 确认收货
接口地址:/order/confirmReceive
接口交互:GET
接口描述:确认收货
header入参
| Parameter | Sample value | Optional | Description |
|---|---|---|---|
| ak | 0130000 | M | 版本号 |
| sessionid | 20161110124538 | M | 会话ID |
| userid | 66666 | M | 用户id |
form入参
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| orderId | string | 订单ID | 1 |
响应
| Parameter | 描述 | 例子 |
|---|---|---|
| status | string | 0000：成功 |
| message | string | 提示 |
6. 查看物流
接口地址:/order/expressQuery
接口交互:GET
接口描述:查看物流
header入参
| Parameter | Sample value | Optional | Description |
|---|---|---|---|
| ak | 0130000 | M | 版本号 |
| sessionid | 20161110124538 | M | 会话ID |
| userid | 66666 | M | 用户id |
query入参
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| orderId | string | 订单ID | 1 |
响应
| Parameter | 描述 | 例子 |
|---|---|---|
| status | string | 0000：成功 |
| message | string | 提示 |
| result | string | 物流信息 |
result数据结构
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| orderId | string | 订单ID | 1 |
| wayBillId | string | 运单号码 | 3315303517507 |
| expressCompany | string | 物流公司 | 申通快递 |
| deliveryAddr | string | 发货地址 | 1 |
| receiptAddr | string | 收货地址 | 1 |
| expressTrace | string | 物流追踪信息 | 1 |
expressTrace数据结构
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| traceTime | string | 时间 | 1 |
| traceRemark | string | 物流信息描述 | 1 |