## 获取搭配购活动单条信息(mealRead) >[info] 场景说明:获取指定ID的搭配购活动详细信息 ### 是否需要获取用户TOKEN `否` ***** ### 请求地址 ``` POST http://api.xxx.com/meal/read ``` ### 公共请求参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | 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`格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | meal\_id | integer | 必须 | 搭配购活动ID | | queryitem | boolean | 可选 | 是否获取搭配购商品信息,默认为:true | ### 请求示例 ``` { "appid": "您的APPID", "version": "v3", "sign_type": "md5", "timestamp": "2020-8-10 12:00:00", "format": "json", "sign": "op0987yhjmngt54rtg2wgdfvcder2765", "params": { "meal_id": 12 } } ``` ***** ### 公共返回参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | code | integer | 必须 | 0=成功,其它值代表请求失败的错误代码,请参考:[公共错误码](response-code.md) | | message | string | 必须 | 请求成功/失败的描述信息 | | data | array | 必须 | 返回结果,如果没有数据则返回空 | 返回`data`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | meal\_id | integer | 必须 | 搭配购活动ID | | title | string | 必须 | 搭配购活动标题 | | store\_id | integer | 必须 | 店铺ID | | store\_name | string | 必须 | 店铺名称 | | price | decimal | 必须 | 搭配购商品默认规格下的原价格总额(未考虑营销工具下的优惠) | | mealPrice | decimal | 必须 | 搭配购价格 (购买价格) | | \+ items | list | 必须 | 搭配购包含的商品列表,queryitem=true 时有该值 | | └ goods\_id | integer | 必须 | 商品ID | | └ goods\_name | string | 必须 | 商品名称 | | └ goods\_image | string | 必须 | 商品图片 | | └ price | decimal | 必须 | 商品单价 | | └ sales | integer | 必须 | 商品销量 | | └ spec\_id | integer | 必须 | 默认规格ID | | └ spec\_name\_1 | string | 必须 | 商品规格一名称 | | └ spec\_name\_2 | string | 必须 | 商品规格二名称 | | └ specification | string | 必须 | 商品默认规格组合值 | | └ spec\_qty | integer | 必须 | 规格数量 | | └ meal\_id | integer | 必须 | 搭配购活动ID | | └ + specs | list | 必须 | 搭配购商品所有规格列表 | | <span>   </span>└ goods\_id | integer | 必须 | 商品ID | | <span>   </span>└ image | string | 必须 | 规格图片 | | <span>   </span>└ spec\_id | integer | 必须 | 商品规格ID | | <span>   </span>└ spec\_1 | string | 必须 | 规格一值 | | <span>   </span>└ spec\_2 | string | 必须 | 规格二值 | | <span>   </span>└ price | decimal | 必须 | 该规格商品单价 | | status | integer | 必须 | 活动状态,1=有效,0=无效 | | created | string | 必须 | 活动创建时间 | ### 返回数据示例 ``` { "code": 0, "message": "成功", "data": { meal_id:1, created:"2021-03-30 16:22:22", items:[ { goods_id:46, goods_image:"https://app.shopwind.net/data/files/store\_2/goods/20210201173420680.jpg.thumb.jpg", goods_name:"Apple AirPods Pro 主动降噪无线蓝牙耳机 适用iPhone/iPad/Apple Watch", meal_id:1, price:1899.00, sales:11, spec_id:148, spec_name_1:"颜色", spec_name_2:"版本", spec_qty:2, specification:"颜色:白色 版本:官方标配", specs:[ { goods_id:46, image:"", price:1899.00, spec_1:"白色", spec_2:"官方标配", spec_id:148 } ] } ], mealPrice:7000.00, price:8007, status:1, store_id:2, store_name: "超级店铺", title:"搭配买" } } ```