外卖店铺商品列表(2.5)
<p><strong>简要描述:</strong> </p>
<ul>
<li>用户APP查询分类商品列表
优先级必点>折扣>推荐=普通分类。必点:打上必点标签的商品;折扣:有折扣的商品,不包含必点商品;推荐:打上推荐标签的商品,不包含必点和折扣商品;普通分类:不包含必点和折扣商品。</li>
</ul>
<p><strong>作者:</strong> </p>
<ul>
<li>徐辉</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>/xtwl_read_interface/cmd</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>参数:</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必填</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">shopId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商家ID</td>
</tr>
<tr>
<td style="text-align: left;">shopType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>商家类别:1外卖,2团购,3商城</td>
</tr>
</tbody>
</table>
<p><strong>请求示例</strong></p>
<pre><code> {
"version": "1.5",
"modular":"goods",
"requestname":"us_queryGoodsList",
"param": {
"authKey": "0",
"userKey": "760D18C2D9B454B0E053161EA8C0FEFC",
"timeStamp": "3423452353454",
"secretKey": "48EAF3777B978B3542EC09FA3AB4DC38" ,
"uuid": "dd0bf721-da04-4761-b247-3d6ecd9d9127",
"dtype": "4",
"shopId": "760AF39F47864E60E053161EA8C0278A",
"shopType":1
}
}</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;"><strong>typeId</strong></td>
<td style="text-align: left;">string</td>
<td><strong>类别id (1必点,-1折扣,0推荐,2是最近买过)(2.5)</strong></td>
</tr>
<tr>
<td style="text-align: left;">originalTypeId</td>
<td style="text-align: left;">string</td>
<td>原来的类别id (推荐商品才返回)</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">string</td>
<td>分类名称</td>
</tr>
<tr>
<td style="text-align: left;">goodsId</td>
<td style="text-align: left;">string</td>
<td>商品Id</td>
</tr>
<tr>
<td style="text-align: left;">picture</td>
<td style="text-align: left;">string</td>
<td>商品图片</td>
</tr>
<tr>
<td style="text-align: left;">originalPicture</td>
<td style="text-align: left;">string</td>
<td>原商品图片</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">string</td>
<td>商品名称</td>
</tr>
<tr>
<td style="text-align: left;">qty</td>
<td style="text-align: left;">int</td>
<td>库存</td>
</tr>
<tr>
<td style="text-align: left;">saleNum</td>
<td style="text-align: left;">int</td>
<td>销量</td>
</tr>
<tr>
<td style="text-align: left;">price</td>
<td style="text-align: left;">string</td>
<td>价格</td>
</tr>
<tr>
<td style="text-align: left;">description</td>
<td style="text-align: left;">string</td>
<td>商品描述</td>
</tr>
<tr>
<td style="text-align: left;">propertys</td>
<td style="text-align: left;">string</td>
<td>商品属性</td>
</tr>
<tr>
<td style="text-align: left;">isShow</td>
<td style="text-align: left;">int</td>
<td>是否显示多规格选项(1显示,0不显示)</td>
</tr>
<tr>
<td style="text-align: left;">isMultiSpec</td>
<td style="text-align: left;">int</td>
<td>是否为多规格:1是,0否</td>
</tr>
<tr>
<td style="text-align: left;">discountAmount</td>
<td style="text-align: left;">string</td>
<td>折扣百分比</td>
</tr>
<tr>
<td style="text-align: left;">limitedNumber</td>
<td style="text-align: left;">int</td>
<td>折扣商品限购数量。返回9999表示无限制</td>
</tr>
<tr>
<td style="text-align: left;">discountPrice</td>
<td style="text-align: left;">string</td>
<td>折扣价</td>
</tr>
<tr>
<td style="text-align: left;">rate</td>
<td style="text-align: left;">string</td>
<td>好评率</td>
</tr>
<tr>
<td style="text-align: left;">boxPrice</td>
<td style="text-align: left;">string</td>
<td>打包盒价格</td>
</tr>
<tr>
<td style="text-align: left;">isRecommend</td>
<td style="text-align: left;">int</td>
<td>是否推荐:1是,0否</td>
</tr>
<tr>
<td style="text-align: left;">isMustBuy</td>
<td style="text-align: left;">String</td>
<td><strong>是否必点</strong>:1是 0否</td>
</tr>
<tr>
<td style="text-align: left;">startSale</td>
<td style="text-align: left;">String</td>
<td><strong>起售数</strong></td>
</tr>
<tr>
<td style="text-align: left;">unit</td>
<td style="text-align: left;">String</td>
<td><strong>商品单位</strong></td>
</tr>
<tr>
<td style="text-align: left;"><strong>isNew</strong></td>
<td style="text-align: left;">integer</td>
<td><strong>是否新品(2.5)</strong></td>
</tr>
<tr>
<td style="text-align: left;"><strong>isFacia</strong></td>
<td style="text-align: left;">integer</td>
<td><strong>是否招牌(2.5)</strong></td>
</tr>
<tr>
<td style="text-align: left;"><strong>isPreSale</strong></td>
<td style="text-align: left;">integer</td>
<td><strong>商品当前是否预售状态(2.5)</strong></td>
</tr>
<tr>
<td style="text-align: left;"><strong>saleWeek</strong></td>
<td style="text-align: left;">integer</td>
<td><strong>售卖的周天数,周日是1(2.5)</strong></td>
</tr>
<tr>
<td style="text-align: left;"><strong>saleHours</strong></td>
<td style="text-align: left;">integer</td>
<td><strong>售卖的时间区间(2.5)</strong></td>
</tr>
<tr>
<td style="text-align: left;"><strong>recommendList</strong></td>
<td style="text-align: left;">list</td>
<td><strong>2.5版本独立的推荐商品列表(2.5)</strong></td>
</tr>
<tr>
<td style="text-align: left;"><strong>discountStock</strong></td>
<td style="text-align: left;">integer</td>
<td>折扣商品的库存,-1表示无限库存<strong>(2.5.1)</strong></td>
</tr>
<tr>
<td style="text-align: left;"><strong>likeCount</strong></td>
<td style="text-align: left;">integer</td>
<td><strong>点赞数(4.0)</strong></td>
</tr>
<tr>
<td style="text-align: left;">labelList.labelId</td>
<td style="text-align: left;">String</td>
<td><strong>标签id</strong></td>
</tr>
<tr>
<td style="text-align: left;">labelList.labelName</td>
<td style="text-align: left;">String</td>
<td><strong>标签名</strong></td>
</tr>
<tr>
<td style="text-align: left;">labelList.sort</td>
<td style="text-align: left;">Integer</td>
<td><strong>排序</strong></td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
"result": {
"list": [{
"typeId": "1",
"name": "必点",
"goodsList": [{
"goodsId": "ADBF190CA7314A8AA4A7A77592C88CFD",
"picture": "https://img.91xfcs.com/de3b12d81144b1a3c89fcc7a924750a5?w=140&h=140",
"originalPicture": "https://img.91xfcs.com/de3b12d81144b1a3c89fcc7a924750a5?p=0",
"name": "超级好吃的大肉饼超级好吃的大肉饼哈哈哈",
"description": "哈哈哈哈哈或或或或或或或或或或或或或或或或或或或或或或或或或",
"saleNum": 0,
"price": "3333",
"qty": 99999,
"isMultiSpec": 0,
"isShow": 0,
"discountAmount": "00.01",
"limitedNumber": 9999,
"discountPrice": "15",
"rate": "100",
"boxPrice": "0",
"typeId": "1",
"originalTypeId": "43FA96841AF2435081FC56F28A40858F",
"shopId": "760AF39F47864E60E053161EA8C0278A",
"isRecommend": 1,
"isMustBuy": 1,
"startSale": "1",
"unit": "个哥哥哥",
"isNew":1,
"isFacia":1,
"isPreSale":1,
"saleWeek":"1,2,3,4",
"saleHours":"09:00-18:00"
},
{
"goodsId": "2BBC2342320948A889ACEADB0887CE21",
"picture": "https://img.91xfcs.com/3fae9c369cbc44568a171e12d5fc8a76?w=140&h=140",
"originalPicture": "https://img.91xfcs.com/3fae9c369cbc44568a171e12d5fc8a76?p=0",
"name": "花",
"saleNum": 0,
"price": "0.01",
"qty": 99,
"isMultiSpec": 0,
"isShow": 0,
"rate": "100",
"boxPrice": "0",
"typeId": "1",
"originalTypeId": "0C67F611E1934A3EBE600E21DFF9E824",
"shopId": "760AF39F47864E60E053161EA8C0278A",
"isRecommend": 1,
"isMustBuy": 1,
"startSale": "3",
"unit": "个个个个"
},
{
"goodsId": "01D243D97F524F039927E9FBCC14E51A",
"picture": "https://img.91xfcs.com/43f60e6c3efd5aa6092347533b8e9c29?w=140&h=140",
"originalPicture": "https://img.91xfcs.com/43f60e6c3efd5aa6092347533b8e9c29?p=0",
"name": "鼠标",
"saleNum": 0,
"price": "0.05",
"qty": 99,
"isMultiSpec": 0,
"isShow": 0,
"rate": "100",
"boxPrice": "0",
"typeId": "1",
"originalTypeId": "682A73D7EAD64E1AA18E5D572B4A4F9C",
"shopId": "760AF39F47864E60E053161EA8C0278A",
"isRecommend": 0,
"isMustBuy": 1,
"startSale": "10"
}]
},
{
"typeId": "-1",
"name": "折扣",
"goodsList": [{
"goodsId": "DE871DF42BA3465BA6D8BACEE01B75D6",
"picture": "https://img.91xfcs.com/f238ac59ed26290b274d677c179306e7?w=140&h=140",
"originalPicture": "https://img.91xfcs.com/f238ac59ed26290b274d677c179306e7?p=0",
"name": "燕麦面包燕麦面包燕麦面包燕麦面包燕麦面包燕麦面包",
"saleNum": 0,
"price": "222",
"qty": 99999,
"isMultiSpec": 0,
"isShow": 0,
"discountAmount": "0.05",
"limitedNumber": -1,
"discountPrice": "1",
"rate": "100",
"boxPrice": "0",
"typeId": "-1",
"shopId": "760AF39F47864E60E053161EA8C0278A",
"isRecommend": 0,
"isMustBuy": 0,
"startSale": "1"
},
{
"goodsId": "4B13FEF2DB7A4DA589B75B3D80EF5063",
"picture": "https://img.91xfcs.com/133b480d361685b9e5af8ccadb80efc5?w=140&h=140",
"originalPicture": "https://img.91xfcs.com/133b480d361685b9e5af8ccadb80efc5?p=0",
"name": "香辣鸡腿堡",
"description": "哈啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊",
"saleNum": 0,
"price": "10",
"qty": 99999,
"isMultiSpec": 0,
"isShow": 0,
"discountAmount": "0.01",
"limitedNumber": -1,
"discountPrice": "0.01",
"rate": "100",
"boxPrice": "0",
"typeId": "-1",
"shopId": "760AF39F47864E60E053161EA8C0278A",
"isRecommend": 0,
"isMustBuy": 0,
"startSale": "1",
"unit": "个个个个个个"
}]
},
{
"typeId": "0",
"name": "推荐",
"goodsList": [{
"goodsId": "E1023263BD4F494AA2B21885A86311D6",
"picture": "https://img.91xfcs.com/e30709a81aca4f17e90580debe4de3b4?w=140&h=140",
"originalPicture": "https://img.91xfcs.com/e30709a81aca4f17e90580debe4de3b4?p=0",
"name": "很香的炒菜很香的炒菜哈哈哈哈啦啦呵呵呵呵",
"saleNum": 0,
"price": "0.01",
"qty": 99,
"isMultiSpec": 0,
"isShow": 0,
"rate": "100",
"boxPrice": "0",
"typeId": "0",
"originalTypeId": "0C67F611E1934A3EBE600E21DFF9E824",
"shopId": "760AF39F47864E60E053161EA8C0278A",
"isRecommend": 1,
"isMustBuy": 0,
"startSale": "5"
},
{
"goodsId": "D5D359DCF371492D96D349F589A23FF9",
"picture": "https://img.91xfcs.com/10f47545c06c06c0a937562ed6d2a259?w=140&h=140",
"originalPicture": "https://img.91xfcs.com/10f47545c06c06c0a937562ed6d2a259?p=0",
"name": "芒果蛋糕",
"saleNum": 0,
"price": "0.01",
"qty": 99,
"isMultiSpec": 1,
"isShow": 1,
"rate": "100",
"boxPrice": "0",
"typeId": "0",
"originalTypeId": "682A73D7EAD64E1AA18E5D572B4A4F9C",
"shopId": "760AF39F47864E60E053161EA8C0278A",
"isRecommend": 1,
"isMustBuy": 0,
"startSale": "3"
}]
},
{
"typeId": "AB28E1D21FC145D48DCF352EEF2A6980",
"name": "默认分类",
"goodsList": [{
"goodsId": "BE3B86A7674C4D9D934186AAC0ED51C1",
"picture": "https://img.91xfcs.com/9a4ce44977b175cc018bd049facf5c0b?w=140&h=140",
"originalPicture": "https://img.91xfcs.com/9a4ce44977b175cc018bd049facf5c0b?p=0",
"name": "面包",
"saleNum": 0,
"price": "0.01",
"qty": 99999,
"isMultiSpec": 0,
"isShow": 0,
"rate": "100",
"boxPrice": "0",
"typeId": "AB28E1D21FC145D48DCF352EEF2A6980",
"shopId": "760AF39F47864E60E053161EA8C0278A",
"isRecommend": 0,
"isMustBuy": 0,
"startSale": "1"
},
{
"goodsId": "3683432CD67343C5B70E192572CEF203",
"picture": "https://img.91xfcs.com/b20d519c20209baf0e82035ef80a5d83?w=140&h=140",
"originalPicture": "https://img.91xfcs.com/b20d519c20209baf0e82035ef80a5d83?p=0",
"name": "超级好吃的蛋糕",
"saleNum": 0,
"price": "0.01",
"qty": 99999,
"isMultiSpec": 0,
"isShow": 0,
"rate": "100",
"boxPrice": "0",
"typeId": "AB28E1D21FC145D48DCF352EEF2A6980",
"shopId": "760AF39F47864E60E053161EA8C0278A",
"isRecommend": 0,
"isMustBuy": 0,
"startSale": "1"
},
{
"goodsId": "27AA652BE1C7458EBC01055ABD3A867B",
"picture": "https://img.91xfcs.com/195218edaea77aa7b718b6b87aaf06b7?w=140&h=140",
"originalPicture": "https://img.91xfcs.com/195218edaea77aa7b718b6b87aaf06b7?p=0",
"name": "77788",
"saleNum": 0,
"price": "77",
"qty": 99999,
"isMultiSpec": 0,
"isShow": 0,
"rate": "100",
"boxPrice": "0",
"typeId": "AB28E1D21FC145D48DCF352EEF2A6980",
"shopId": "760AF39F47864E60E053161EA8C0278A",
"isRecommend": 0,
"isMustBuy": 0,
"startSale": "1"
}]
},
{
"typeId": "0C67F611E1934A3EBE600E21DFF9E824",
"name": "美食美食美食美食美食",
"goodsList": [{
"goodsId": "A0138B9AB630439FA4FD64DBF2BB38AE",
"picture": "https://img.91xfcs.com/75d614a064bbeab6a1116e8bd21a5245?w=140&h=140",
"originalPicture": "https://img.91xfcs.com/75d614a064bbeab6a1116e8bd21a5245?p=0",
"name": "雪糕",
"saleNum": 0,
"price": "0.01",
"qty": 99999,
"isMultiSpec": 0,
"isShow": 0,
"rate": "100",
"boxPrice": "0",
"typeId": "0C67F611E1934A3EBE600E21DFF9E824",
"shopId": "760AF39F47864E60E053161EA8C0278A",
"isRecommend": 0,
"isMustBuy": 0,
"startSale": "1",
"unit": "斤斤斤"
},
{
"goodsId": "87D4819A092C4F54B0F3E673381BE92F",
"picture": "https://img.91xfcs.com/ade1d4b9a58fd7fcd2e3d28e46ca736f?w=140&h=140",
"originalPicture": "https://img.91xfcs.com/ade1d4b9a58fd7fcd2e3d28e46ca736f?p=0",
"name": "经典菲力牛排",
"saleNum": 0,
"price": "0.01",
"qty": 99,
"propertys": "甜度:少糖,多糖,无糖",
"isMultiSpec": 1,
"isShow": 1,
"rate": "100",
"boxPrice": "0",
"typeId": "0C67F611E1934A3EBE600E21DFF9E824",
"shopId": "760AF39F47864E60E053161EA8C0278A",
"isRecommend": 0,
"isMustBuy": 0,
"startSale": "5",
"unit": "500g"
},
{
"goodsId": "E1023263BD4F494AA2B21885A86311D6",
"picture": "https://img.91xfcs.com/e30709a81aca4f17e90580debe4de3b4?w=140&h=140",
"originalPicture": "https://img.91xfcs.com/e30709a81aca4f17e90580debe4de3b4?p=0",
"name": "很香的炒菜很香的炒菜哈哈哈哈啦啦呵呵呵呵",
"saleNum": 0,
"price": "0.01",
"qty": 99,
"isMultiSpec": 0,
"isShow": 0,
"rate": "100",
"boxPrice": "0",
"typeId": "0C67F611E1934A3EBE600E21DFF9E824",
"shopId": "760AF39F47864E60E053161EA8C0278A",
"isRecommend": 1,
"isMustBuy": 0,
"startSale": "5"
}]
},
{
"typeId": "682A73D7EAD64E1AA18E5D572B4A4F9C",
"name": "蛋糕蛋糕蛋糕",
"goodsList": [{
"goodsId": "66F7104E810944D3A3B9888377610DB9",
"picture": "https://img.91xfcs.com/e4d40ac32b06a17befc1e0d3d62867d5?w=140&h=140",
"originalPicture": "https://img.91xfcs.com/e4d40ac32b06a17befc1e0d3d62867d5?p=0",
"name": "墨西哥鸡肉卷",
"saleNum": 0,
"price": "0.01",
"qty": 99999,
"isMultiSpec": 0,
"isShow": 0,
"rate": "100",
"boxPrice": "0",
"typeId": "682A73D7EAD64E1AA18E5D572B4A4F9C",
"shopId": "760AF39F47864E60E053161EA8C0278A",
"isRecommend": 0,
"isMustBuy": 0,
"startSale": "1"
},
{
"goodsId": "D5D359DCF371492D96D349F589A23FF9",
"picture": "https://img.91xfcs.com/10f47545c06c06c0a937562ed6d2a259?w=140&h=140",
"originalPicture": "https://img.91xfcs.com/10f47545c06c06c0a937562ed6d2a259?p=0",
"name": "芒果蛋糕",
"saleNum": 0,
"price": "0.01",
"qty": 99,
"isMultiSpec": 1,
"isShow": 1,
"rate": "100",
"boxPrice": "0",
"typeId": "682A73D7EAD64E1AA18E5D572B4A4F9C",
"shopId": "760AF39F47864E60E053161EA8C0278A",
"isRecommend": 1,
"isMustBuy": 0,
"startSale": "3"
}]
}],
"recommendList": [{
"goodsId": "ADBF190CA7314A8AA4A7A77592C88CFD",
"picture": "https://img.91xfcs.com/de3b12d81144b1a3c89fcc7a924750a5?w=140&h=140",
"originalPicture": "https://img.91xfcs.com/de3b12d81144b1a3c89fcc7a924750a5?p=0",
"name": "超级好吃的大肉饼超级好吃的大肉饼哈哈哈",
"description": "哈哈哈哈哈或或或或或或或或或或或或或或或或或或或或或或或或或",
"saleNum": 0,
"price": "3333",
"qty": 99999,
"isMultiSpec": 0,
"isShow": 0,
"discountAmount": "00.01",
"limitedNumber": 9999,
"discountPrice": "15",
"rate": "100",
"boxPrice": "0",
"typeId": "1",
"originalTypeId": "43FA96841AF2435081FC56F28A40858F",
"shopId": "760AF39F47864E60E053161EA8C0278A",
"isRecommend": 1,
"isMustBuy": 1,
"startSale": "1",
"unit": "个哥哥哥"
}]
},
"resultcode": "0",
"resultdesc": "success"
}</code></pre>
<p><strong>备注</strong> </p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>