## 获取我购买的订单列表(myOrderList) >[info] 场景说明:获取我购买的订单的数据列表 ### 是否需要获取用户TOKEN `是` ***** ### 请求地址 ``` POST http://api.xxx.com/my/order/list ``` ### 公共请求参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | appid | string | 必须 | 平台提供的唯一APPID | | version | string | 必须 | 接口版本号,固定填:v3 | | sign\_type | string | 必须 | 签名类型,目前只支持md5 | | timestamp | string | 必须 | 发起时间戳,格式为:yyyy-mm-dd hh::ii::ss | | format | string | 必须 | 返回的数据格式,只支持json | | sign | string | 必须 | 请求参数的签名,请参考:[签名规则](signature.md) | | token | string | 必须 | 用户TOKEN | | params | string | 必须 | 请求参数的集合,除公共参数外,所有请求参数都必须放在这个参数中传递,json\_encode后送入 | 应用请求参数`params`格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | type | string | 可选 | 订单类型,取值:"pending"=待付款的订单、"accepted"=待发货的订单、"shipped"=已发货的订单、"picking"=待配货订单、"delivered"=待取货订单、"finished"=已完成的订单、"canceled"=已取消的订单 | | evaluation\_status | integer | 可选 | 评价状态,1=买家已评价,0=买家未评价 | | queryitem | boolean | 可选 | 是否返回订单商品数据,默认:false | | page | integer | 可选 | 当前页 | | page\_size | integer | 可选 | 每页读取多少条记录,默认10条 | ### 请求示例 ``` { "appid": "您的APPID", "version": "v3", "sign_type": "md5", "timestamp": "2020-8-10 12:00:00", "format": "json", "sign": "op0987yhjmngt54rtg2wgdfvcder2765", "params": { "queryitem": true } } ``` ***** ### 公共返回参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | code | integer | 必须 | 0=成功,其它值代表请求失败的错误代码,请参考:[公共错误码](response-code.md) | | message | string | 必须 | 请求成功/失败的描述信息 | | \+ data | array | 必须 | 返回结果,如果没有指定用返回空 | | └ list | list | 必须 | 订单列表 | | └ pagination | array | 必须 | 分页信息 | 返回`data->list`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | orde\_id | integer | 必须 | 订单ID | | order\_sn | string | 必须 | 订单编号 | | tradeNo | string | 必须 | 交易号 | | bizOrderId | string | 必须 | 商户订单号,该值等于order\_sn | | bizIdentity | string | 必须 | 订单业务类型,这里为值:trade10001,取值参考:[订单业务类型代码](order-code.md) | | otype | string | 必须 | 订单类型,取值:"normal"=普通购物订单、"meal"=搭配购订单、"teambuy"=拼团订单、"guidebuy"=社区团购订单 | | gtype | string | 必须 | 商品类型,目前只支持:"material"=实物商品 | | buyer\_id | integer | 必须 | 买家ID | | buyer\_name | string | 必须 | 买家用户名 | | seller\_id | integer | 必须 | 卖家ID | | seller\_name | string | 必须 | 卖家名称 | | status | integer | 必须 | 订单状态,具体参考:[订单状态码](response-code.md) | | evaluation\_status | integer | 必须 | 订单评价状态:1=买家已评、0=买家未评 | | payment\_code | string | 必须 | 支付方式代号,请参考:[支付方式代码](payment-code.md) | | payment\_name | string | 必须 | 支付方式名称 | | express\_no | string | 可选 | 快递单号,已发货的订单必填 | | express\_comkey | string | 可选 | 快递公司代码 | | express\_company | string | 可选 | 快递公司名称 | | order\_amount | decimal | 必须 | 订单金额 | | goods\_amount | decimal | 必须 | 商品金额 | | shipping\_fee | decimal | 必须 | 运费金额 | | postscript | string | 可选 | 买家下单留言 | | memo | string | 可选 | 卖家订单备注 | | add\_time | string | 必须 | 订单生成时间,格式:yyyy-mm-dd hh::ii::ss | | pay\_time | string | 可选 | 订单付款时间 | | ship\_time | string | 可选 | 订单发货时间 | | finished\_time | string | 可选 | 订单完成时间 | | evaluation\_time | string | 可选 | 订单评价时间(买家评) | | guider\_id | integer | 可选 | 团长ID,当 otype="localbuy" 即社区团购订单时有该值 | | refund\_id | integer | 可选 | 退款ID,如该订单有退款时有值 | | refund\_sn | string | 可选 | 退款编号,如该订单有退款时有值 | | refund\_status | string | 可选 | 退款状态,取值请参考:[退款状态码](response-code.md) | | \+ items | list | 可选 | 订单商品列表,当queryitem=true时必填 | | └ rec\_id | integer | 必须 | 记录ID | | └ spec\_id | integer | 必须 | 商品规格(SKUID) | | └ order\_id | integer | 必须 | 订单ID | | └ goods\_id | integer | 必须 | 商品ID | | └ goods\_name | string | 必须 | 商品名称 | | └ goods\_image | string | 必须 | 商品图片 | | └ specification | string | 可选 | 商品规格组合 | | └ price | decimal | 必须 | 商品价格 | | └ quantity | integer | 必须 | 购买数量 | 返回`data->pagination`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | integer | 必须 | 当前页 | | page\_size | integer | 必须 | 每一页显示的数据量 | | page\_count | integer | 必须 | 总页数 | | total | integer | 必须 | 总记录数 | ### 返回数据示例 ``` { "code": 0, "message": "成功", "data": { "list": [ { "order_id":3, "order_sn":"15990694324571092", "tradeNo": "20200911105418341468", "bizOrderId": "15990694324571092", "bizIdentity": "trade10001", "otype": "normal", "gtype": "material", "buyer_id":2, "buyer_name": "buyer", "seller_id":2 "seller_name": "演示店铺", "status": 20, "evaluation_status": 0, "payment_code": "deposit", "payment_name": "余额支付", "express_no": "", "express_comkey": "", "express_company": "", "order_amount": 200.00, "goods_amount": 190.00, "shipping_fee": 10.00, "postscript": "", "memo": "", "add_time": "2020-9-11 10:54:17", "pay_time": "2020-9-11 11:13:48", "ship_time": "", "finished_time": "", "evaluation_time": "", "items": [ { "rec_id": 14, "spec_id":4, "order_id": 9, "price": 399.99, "quantity": 2, "specification": "颜色:红色", "goods_id": 3, "goods_name": "AUX/奥克斯 KFR-35GW/NFI19+3大1.5匹冷暖定频壁挂式家用空调挂机", "goods_image": "http://www.xxx.com/data/mall/files/goods/20209989487.jpg", } ] } ], "pagination": { "page":1, "page_size":10, "page_count":1, "total":1 } } } ```