## 获取单条订单商品数据(orderGoods) >[info] 场景说明:获取已创建的订单商品列表数据,只有当前登录用户是该订单的买家或卖家时才能返回数据 ### 是否需要获取用户TOKEN `是` ***** ### 请求地址 ``` POST http://api.xxx.com/order/goods ``` ### 公共请求参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | 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`格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | order\_id | integer | 可选 | 订单ID,订单ID和订单编号二者必传其一 | | order\_sn | string | 可选 | 订单编号,订单ID和订单编号二者必传其一 | ### 请求示例 ``` { "appid": "您的APPID", "version": "v3", "sign_type": "md5", "timestamp": "2020-8-10 12:00:00", "format": "json", "sign": "op0987yhjmngt54rtg2wgdfvcder2765", "params": { "order_id": 3 } } ``` ***** ### 公共返回参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | code | integer | 必须 | 0=成功,其它值代表请求失败的错误代码,请参考:[公共错误码](response-code.md) | | message | string | 必须 | 请求成功/失败的描述信息 | | \+ data | array | 必须 | 返回结果,如果没有指定用返回空 | | └ list | list | 必须 | 订单商品列表 | 返回`data->list`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | rec\_id | integer | 必须 | 记录ID | | orde\_id | integer | 必须 | 订单ID | | order\_sn | string | 必须 | 订单编号 | | buyer\_id | integer | 必须 | 买家ID | | seller\_id | integer | 必须 | 卖家ID | | goods\_id | integer | 必须 | 商品ID | | goods\_name | string | 必须 | 商品名称 | | goods\_image | string | 必须 | 商品图片 | | spec\_id | integer | 必须 | 商品规格ID | | price | decimal | 必须 | 商品价格 | | quantity | integer | 必须 | 购买数量 | | subtotal | decimal | 必须 | 价格小计 | | specification | string | 可选 | 商品规格组合,如:颜色:红色 | ### 返回数据示例 ``` { "code": 0, "message": "成功", "data": { "list": [ { "rec_id": 1, "spec_id":4, "price": 399.99, "quantity": 2, "subtotal": 799.98, "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", "order_id":3, "order_sn":"15990694324571092", "buyer_id":2, "seller_id":2 } ] } } ```