大平台——App客户端接口

App接口


商品详情

<p><strong>简要描述:</strong> </p> <ul> <li>商品详情</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;">custId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>客户ID</td> </tr> <tr> <td style="text-align: left;">goodsId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商品id</td> </tr> <tr> <td style="text-align: left;">userLongitude</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>用户经度(小程序需要传)</td> </tr> <tr> <td style="text-align: left;">userLatitude</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>用户纬度(小程序需要传)</td> </tr> <tr> <td style="text-align: left;">isMiniProgram</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>小程序传&quot;1&quot;,其他端不用传</td> </tr> </tbody> </table> <p><strong>请求示例</strong></p> <pre><code>{ "version": "1.0", "modular":"goods", "requestname":"queryAppYXGoodsDetail", "param": { "timeStamp": "1506413463456", "uuid": "dd0bf721-da04-4761-b247-3d6ecd9d9127", "authKey": "0", "secretKey": "48EAF3777B978B3542EC09FA3AB4DC38", "dtype": 2, "userKey": "6EAE49FD43425E97E0532E1E1FACC018", "custId": "EFAD2C1757EA418BABA8D58D49B9DDFB", "goodsId":"B1EF3A7766BB4B6E8361B4AA5E52F161", "userLongitude":"0", "userLatitude":"0", "isMiniProgram":"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;">goodsInfo.goodsId</td> <td style="text-align: left;">String</td> <td>商品id</td> </tr> <tr> <td style="text-align: left;">goodsInfo.goodsName</td> <td style="text-align: left;">String</td> <td>商品名称</td> </tr> <tr> <td style="text-align: left;">goodsInfo.goodsSpec</td> <td style="text-align: left;">String</td> <td>商品规格</td> </tr> <tr> <td style="text-align: left;">goodsInfo.limitedNumber</td> <td style="text-align: left;">String</td> <td>限购 -1无限制</td> </tr> <tr> <td style="text-align: left;">goodsInfo.originalPrice</td> <td style="text-align: left;">String</td> <td>市场价</td> </tr> <tr> <td style="text-align: left;">goodsInfo.price</td> <td style="text-align: left;">String</td> <td>优选价</td> </tr> <tr> <td style="text-align: left;">goodsInfo.qty</td> <td style="text-align: left;">String</td> <td>商品库存</td> </tr> <tr> <td style="text-align: left;">goodsInfo.saleCount</td> <td style="text-align: left;">String</td> <td>销量</td> </tr> <tr> <td style="text-align: left;">goodsInfo.discountAmount</td> <td style="text-align: left;">String</td> <td>已省值</td> </tr> <tr> <td style="text-align: left;">goodsInfo.discountRate</td> <td style="text-align: left;">String</td> <td>折扣比率</td> </tr> <tr> <td style="text-align: left;">goodsInfo.firstLabel</td> <td style="text-align: left;">String</td> <td>标签1</td> </tr> <tr> <td style="text-align: left;">goodsInfo.secondLabel</td> <td style="text-align: left;">String</td> <td>标签2</td> </tr> <tr> <td style="text-align: left;">goodsInfo.thirdLabel</td> <td style="text-align: left;">String</td> <td>标签3</td> </tr> <tr> <td style="text-align: left;">goodsInfo.firstType</td> <td style="text-align: left;">String</td> <td>一级分类</td> </tr> <tr> <td style="text-align: left;">goodsInfo.firstTypeName</td> <td style="text-align: left;">String</td> <td>一级分类名</td> </tr> <tr> <td style="text-align: left;">goodsInfo.goodsEndTime</td> <td style="text-align: left;">String</td> <td>商品下架时间</td> </tr> <tr> <td style="text-align: left;">goodsInfo.goodsImg</td> <td style="text-align: left;">String</td> <td>商品图字符串</td> </tr> <tr> <td style="text-align: left;">goodsInfo.hotSaleSort</td> <td style="text-align: left;">String</td> <td>热榜排名</td> </tr> <tr> <td style="text-align: left;">goodsInfo.isSeckill</td> <td style="text-align: left;">String</td> <td>是否正在秒杀</td> </tr> <tr> <td style="text-align: left;">goodsInfo.seckillPrice</td> <td style="text-align: left;">String</td> <td>秒杀价</td> </tr> <tr> <td style="text-align: left;">goodsInfo.sessionEndTime</td> <td style="text-align: left;">String</td> <td>秒杀结束时间</td> </tr> <tr> <td style="text-align: left;">goodsInfo.priceStrategy</td> <td style="text-align: left;">String</td> <td>定价策略 1已省X元 2 X折</td> </tr> <tr> <td style="text-align: left;">goodsInfo.imgTxtList.content</td> <td style="text-align: left;">String</td> <td>图文内容</td> </tr> <tr> <td style="text-align: left;">goodsInfo.imgTxtList.type</td> <td style="text-align: left;">String</td> <td>图文类型 1图片 2文字</td> </tr> <tr> <td style="text-align: left;">goodsInfo.pictureList</td> <td style="text-align: left;">String</td> <td>商品图片列表</td> </tr> <tr> <td style="text-align: left;">goodsInfo.countDown</td> <td style="text-align: left;">String</td> <td>倒计时 秒</td> </tr> <tr> <td style="text-align: left;">commentList.count</td> <td style="text-align: left;">String</td> <td>评论数量</td> </tr> <tr> <td style="text-align: left;">commentList.list.addTime</td> <td style="text-align: left;">String</td> <td>评论添加时间</td> </tr> <tr> <td style="text-align: left;">commentList.list.content</td> <td style="text-align: left;">String</td> <td>评论内容</td> </tr> <tr> <td style="text-align: left;">commentList.list.headPortrait</td> <td style="text-align: left;">String</td> <td>用户头像</td> </tr> <tr> <td style="text-align: left;">commentList.list.nickname</td> <td style="text-align: left;">String</td> <td>用户昵称</td> </tr> <tr> <td style="text-align: left;">pickupPointInfo.canPickTime</td> <td style="text-align: left;">String</td> <td>可自提时间 hh:mm;d;hh:mm</td> </tr> <tr> <td style="text-align: left;">pickupPointInfo.shopAddress</td> <td style="text-align: left;">String</td> <td>自提地址</td> </tr> <tr> <td style="text-align: left;">pickupPointInfo.shopId</td> <td style="text-align: left;">String</td> <td>自提点id</td> </tr> <tr> <td style="text-align: left;">pickupPointInfo.shopName</td> <td style="text-align: left;">String</td> <td>自提点名称</td> </tr> <tr> <td style="text-align: left;">pickupPointInfo.shopPicture</td> <td style="text-align: left;">String</td> <td>自提点图片</td> </tr> <tr> <td style="text-align: left;">pickupPointInfo.isOpenYxEntrance</td> <td style="text-align: left;">String</td> <td>是否开启优选商品入口 1是 0否</td> </tr> <tr> <td style="text-align: left;">pickupPointInfo.yxEntrancePicture</td> <td style="text-align: left;">String</td> <td>优选商品入口图片</td> </tr> <tr> <td style="text-align: left;">pickupPointInfo.deliveryShopName</td> <td style="text-align: left;">String</td> <td>配送店铺名称</td> </tr> <tr> <td style="text-align: left;">serviceList.content</td> <td style="text-align: left;">String</td> <td>平台服务内容</td> </tr> <tr> <td style="text-align: left;">serviceList.title</td> <td style="text-align: left;">String</td> <td>平台服务标题</td> </tr> <tr> <td style="text-align: left;">goodsYNewUserId</td> <td style="text-align: left;">String</td> <td>新客优享优选商品活动id,不为空说明用户满足新客,商品有新客优惠</td> </tr> <tr> <td style="text-align: left;">priceNewUser</td> <td style="text-align: left;">String</td> <td>新用户活动价</td> </tr> <tr> <td style="text-align: left;">discountAmountNewUser</td> <td style="text-align: left;">String</td> <td>参与新用户活动后已省值</td> </tr> <tr> <td style="text-align: left;">discountRateNewUser</td> <td style="text-align: left;">String</td> <td>参与新用户活动后折扣比率</td> </tr> </tbody> </table> <p><strong>返回示例</strong></p> <pre><code>{ "result": { "commentList": { "count": 0, "list": [] }, "goodsInfo": { "countDown": "4634685", "discountAmount": "4.3", "discountRate": "5.7", "firstLabel": "蔬菜", "firstType": "EF7B09CF0CD541E1B66455D52BAA36A6", "firstTypeName": "蔬菜", "goodsEndTime": "2021-05-05 00:01:00.0", "goodsId": "B1EF3A7766BB4B6E8361B4AA5E52F161", "goodsImg": "4bb575ee13db99e21f4fd6ae9cc18e7e,4bb575ee13db99e21f4fd6ae9cc18e7e", "goodsName": "大蒜", "goodsSpec": "10000吨", "hotSaleSort": "2", "imgTxtList": [ { "content": "很不错", "type": 2 }, { "content": "https://img.58xfcs.com/mg.58xfcs.com/asdasdfgfdrfghdsfe", "type": 1 } ], "isSeckill": "0", "limitedNumber": "-1", "originalPrice": "9.9", "pictureList": [ "https://img.58xfcs.com/4bb575ee13db99e21f4fd6ae9cc18e7e", "https://img.58xfcs.com/4bb575ee13db99e21f4fd6ae9cc18e7e" ], "price": "5.6", "priceStrategy": "1", "qty": "1111", "saleCount": "100", "secondLabel": "健康", "thirdLabel": "营养" }, "pickupPointInfo": { "canPickTime": "13:07点前下单,明天16:00点自提", "distance": "11552714.59", "poindId": "BCC18A8B27E31CA2E053161EA8C0108F", "rn": "1", "shopAddress": "云南省昆明市寻甸仁德镇十字街", "shopId": "A7DC3407F5B94264E053341E1FAC4B86", "shopName": "十字街正宗昭通秘制小肉串", "shopPicture": "https://img.58xfcs.com/d57ecf3ebd83b5a4683636bf74103039", "yxEntrancePicture": "https://img.58xfcs.com/6f48bf1594883b94976125fa9e8af626" }, "serviceList": [ { "content": "极速退款保证", "sort": "1", "title": "极速退款" }, { "content": "456", "sort": "3", "title": "123" }, { "content": "78", "sort": "4", "title": "56" } ] }, "resultcode": "0", "resultdesc": "success" }</code></pre> <p><strong>备注</strong> </p> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML