大平台——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;">queryType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Integer</td> <td>查询类别:1查看商品详情,2通过邀请好友帮砍链接进入</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;">bargainId</td> <td style="text-align: left;">特殊必传</td> <td style="text-align: left;">string</td> <td>砍价信息id,queryType为2时必传</td> </tr> </tbody> </table> <p><strong>请求示例</strong></p> <pre><code>{ "modular": "bargain", "param": { "timeStamp": "1545215052996", "authKey": "0", "secretKey": "DC0D1F9BA876E10FDC3C4826AAA40D85", "dtype": "5", "uuid": "008a09cc-8829-47b3-a78e-74de5a325d1a", "userKey": "6A41AF1669AD4FB6E0530100007F01C0", "custId": "D78AEA3418834147BE226395B0309642", "goodsId": "5596D580B7A9432A93EC10FFB57926C1", "bargainId": "", "queryType": 1 }, "requestname": "queryUserBargainInfo", "source": "1", "version": "2.5" }</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</td> <td style="text-align: left;">商品对象</td> <td>对象</td> </tr> <tr> <td style="text-align: left;">specInfo</td> <td style="text-align: left;">sku对象</td> <td>发起砍价后被选中的sku信息,字段名和specList一致</td> </tr> <tr> <td style="text-align: left;">userView</td> <td style="text-align: left;">Integer</td> <td>用户视角:1未参加砍价/待支付,2发起者砍价中, 3发起者砍价成功,4发起者分享页进入砍价失败, 5参加者未砍价,6参加者砍价中砍价失败砍价成功</td> </tr> <tr> <td style="text-align: left;">isShowHelp</td> <td style="text-align: left;">Integer</td> <td>是否展示帮砍记录:1是,0否</td> </tr> <tr> <td style="text-align: left;">isMoreHelp</td> <td style="text-align: left;">Integer</td> <td>是否有更多帮砍记录:1是,0否</td> </tr> <tr> <td style="text-align: left;">isShowRTime</td> <td style="text-align: left;">Integer</td> <td>是否展示倒计时:1是,0否</td> </tr> <tr> <td style="text-align: left;">isSingle</td> <td style="text-align: left;">Integer</td> <td>是否为单品:1是0否</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;">orderId</td> <td style="text-align: left;">String</td> <td>订单id,已提交过订单的返回orderId, 点击去支付直接跳支付页,不需要重复下单</td> </tr> <tr> <td style="text-align: left;">goodsName</td> <td style="text-align: left;">String</td> <td>商品名称</td> </tr> <tr> <td style="text-align: left;">deliveryType</td> <td style="text-align: left;">Integer</td> <td>配送方式:0不支持配送,1平台物流,2自行配送</td> </tr> <tr> <td style="text-align: left;">isPickup</td> <td style="text-align: left;">Integer</td> <td>是否支持到店自取:1是,0否</td> </tr> <tr> <td style="text-align: left;">isOnlyPickup</td> <td style="text-align: left;">Integer</td> <td>是否仅支持到店自取:1是,0否</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;">pictureList</td> <td style="text-align: left;">List<String></td> <td>商品图片集合</td> </tr> <tr> <td style="text-align: left;">singlePrice</td> <td style="text-align: left;">String</td> <td>商品原价</td> </tr> <tr> <td style="text-align: left;">groupPrice</td> <td style="text-align: left;">String</td> <td>商品底价</td> </tr> <tr> <td style="text-align: left;">countdown</td> <td style="text-align: left;">Long</td> <td>商品活动剩余时间(秒)</td> </tr> <tr> <td style="text-align: left;">partakeNum</td> <td style="text-align: left;">Integer</td> <td>该商品已参加总人数</td> </tr> <tr> <td style="text-align: left;">qty</td> <td style="text-align: left;">Integer</td> <td>剩余库存数</td> </tr> <tr> <td style="text-align: left;">imgTxtContent</td> <td style="text-align: left;">List</td> <td>图文详情集合</td> </tr> <tr> <td style="text-align: left;">imgTxtContent.content</td> <td style="text-align: left;">String</td> <td>文字或图片地址</td> </tr> <tr> <td style="text-align: left;">imgTxtContent.type</td> <td style="text-align: left;">Integer</td> <td>1图片,2文字</td> </tr> <tr> <td style="text-align: left;">specNames</td> <td style="text-align: left;">String</td> <td>规格名称,逗号隔开</td> </tr> <tr> <td style="text-align: left;">specNamesList</td> <td style="text-align: left;">List<String></td> <td>规格名称集合</td> </tr> <tr> <td style="text-align: left;">specList</td> <td style="text-align: left;">List</td> <td>规格集合</td> </tr> <tr> <td style="text-align: left;">specList.specId</td> <td style="text-align: left;">String</td> <td>规格Id</td> </tr> <tr> <td style="text-align: left;">specList.qty</td> <td style="text-align: left;">String</td> <td>sku库存</td> </tr> <tr> <td style="text-align: left;">specList.specs</td> <td style="text-align: left;">List<String></td> <td>sku规格值</td> </tr> <tr> <td style="text-align: left;">bargainId</td> <td style="text-align: left;">String</td> <td>砍价信息id</td> </tr> <tr> <td style="text-align: left;">alreadyAmount</td> <td style="text-align: left;">String</td> <td>已帮砍金额</td> </tr> <tr> <td style="text-align: left;">nowPrice</td> <td style="text-align: left;">String</td> <td>当前价</td> </tr> <tr> <td style="text-align: left;">remainingAmount</td> <td style="text-align: left;">String</td> <td>剩余可帮砍金额</td> </tr> <tr> <td style="text-align: left;">groupNumber</td> <td style="text-align: left;">Integer</td> <td>该砍价总共可帮砍人数</td> </tr> <tr> <td style="text-align: left;">alreadyNumber</td> <td style="text-align: left;">Integer</td> <td>该砍价已帮砍人数</td> </tr> <tr> <td style="text-align: left;">remainingTime</td> <td style="text-align: left;">Long</td> <td>砍价剩余时间(秒)</td> </tr> <tr> <td style="text-align: left;">helpList</td> <td style="text-align: left;">List</td> <td>帮砍记录集合</td> </tr> <tr> <td style="text-align: left;">helpList.helpUserId</td> <td style="text-align: left;">String</td> <td>帮砍用户id</td> </tr> <tr> <td style="text-align: left;">helpList.userPic</td> <td style="text-align: left;">String</td> <td>帮砍用户头像</td> </tr> <tr> <td style="text-align: left;">helpList.helpUserName</td> <td style="text-align: left;">String</td> <td>帮砍用户昵称</td> </tr> <tr> <td style="text-align: left;">helpList.amount</td> <td style="text-align: left;">String</td> <td>帮砍金额</td> </tr> <tr> <td style="text-align: left;">shopInfo</td> <td style="text-align: left;">商家对象</td> <td>对象</td> </tr> <tr> <td style="text-align: left;">shopId</td> <td style="text-align: left;">String</td> <td>商家id</td> </tr> <tr> <td style="text-align: left;">logo</td> <td style="text-align: left;">String</td> <td>商家logo</td> </tr> <tr> <td style="text-align: left;">shopName</td> <td style="text-align: left;">String</td> <td>商家名称</td> </tr> <tr> <td style="text-align: left;">shopServiceTel</td> <td style="text-align: left;">String</td> <td>商家电话</td> </tr> <tr> <td style="text-align: left;">shopAddress</td> <td style="text-align: left;">String</td> <td>商家地址</td> </tr> <tr> <td style="text-align: left;">shopLongitude</td> <td style="text-align: left;">String</td> <td>商家经度</td> </tr> <tr> <td style="text-align: left;">shopLatitude</td> <td style="text-align: left;">String</td> <td>商家维度</td> </tr> <tr> <td style="text-align: left;">goodsCount</td> <td style="text-align: left;">Integer</td> <td>店铺商品数</td> </tr> <tr> <td style="text-align: left;">saleNumber</td> <td style="text-align: left;">Integer</td> <td>拼团销量</td> </tr> <tr> <td style="text-align: left;">isShopAddress</td> <td style="text-align: left;">Integer</td> <td>取货地址是否为店铺地址:1是0否(2.5)</td> </tr> <tr> <td style="text-align: left;">pickAddress</td> <td style="text-align: left;">string</td> <td>取货地址(已经判断过是否为店铺地址 页面直接取就行 2.5)</td> </tr> <tr> <td style="text-align: left;">pickLongitude</td> <td style="text-align: left;">string</td> <td>取货地址经度(已经判断过是否为店铺地址 页面直接取就行 2.5)</td> </tr> <tr> <td style="text-align: left;">pickLatitude</td> <td style="text-align: left;">string</td> <td>取货地址纬度(已经判断过是否为店铺地址 页面直接取就行 2.5)</td> </tr> </tbody> </table> <p><strong>返回示例</strong></p> <pre><code>{ "resultcode": "1002", "resultdesc": "一股神秘的力量将商品带走了" } { "result": { "goodsInfo": { "alreadyAmount": "5.99", "alreadyNumber": 2, "bargainId": "699390F73FD44B0AB2E50AA6A9BF28B7", "countdown": 31877701, "deliveryType": 1, "goodsId": "F56AE9B3064E4DF583BFA296680CFCC9", "goodsName": "多规格2", "groupNumber": 2, "groupPrice": "0.01", "helpList": [ { "amount": "0.69", "helpUserId": "82DCDFAFD6271FF9E0532E1E1FACDE6C", "helpUserName": "勋", "userPic": "https://wx.qlogo.cn/mmopen/vi_32/tpsEyGrvQ0u0ohSeIVyWvLMgkpu8p2EeZGdvtiboKwpvxRlOAXOLR2WOJ2LKOoSEFIkLc0vQTHyCJHTc5dzfyHw/132" }, { "amount": "5.3", "helpUserId": "7FA00D9884525347E0532E1E1FAC7646", "helpUserName": "一只骑着鱼的猫", "userPic": "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTI3tbicwozMXHZkXLAWA9ZtichribdVMcy1uFmtBjibg9NYbGjYTpsj9dKiatq0Ta6icK6notrnv2GajbjA/132" } ], "imgTxtContent": [ { "content": "22", "goodsId": "F56AE9B3064E4DF583BFA296680CFCC9", "sort": 1, "type": 2 }], "isMoreHelp": 0, "isOnlyPickup": 0, "isPickup": 1, "isShopAddress": 1, "isShowHelp": 1, "isShowRTime": 1, "isSingle": 0, "nowPrice": "0.01", "orderId": "0045BC6251B047758BC55F9B954026D7", "partakeNum": 12, "pickAddress": "华士大酒店", "pickLatitude": "31.839454", "pickLongitude": "120.4668", "picture": "https://img.58xfcs.com/9b08cde662f215626096c008ff96fe75", "pictureList": [ "https://img.58xfcs.com/9b08cde662f215626096c008ff96fe75", "https://img.58xfcs.com/893052abdf93bccea1803d68637f17e5" ], "qty": 665, "remainingAmount": "0", "remainingTime": 72299, "singlePrice": "6", "skuId": "B1DE410A45CE498894FF0084A122DD31", "specList": [ { "goodsId": "F56AE9B3064E4DF583BFA296680CFCC9", "groupPrice": "0.01", "qty": "221", "saleNumber": "9", "singlePrice": "6", "specId": "46E8C1CEC69A4F18B07E73EC1B5F763F", "specs": [ "3", "阿斯蒂芬", "333" ] }, { "goodsId": "F56AE9B3064E4DF583BFA296680CFCC9", "groupPrice": "0.01", "qty": "222", "saleNumber": "0", "singlePrice": "6", "specId": "9DB62088EE5246A1979B288C08383DA2", "specs": [ "4", "发发", "333" ] }, { "goodsId": "F56AE9B3064E4DF583BFA296680CFCC9", "groupPrice": "0.01", "qty": "222", "saleNumber": "2", "singlePrice": "6", "specId": "B1DE410A45CE498894FF0084A122DD31", "specs": [ "2", "阿萨德", "222" ] } ], "specNames": "尺寸,颜色,型号款式", "specNamesList": [ "尺寸", "颜色", "型号款式" ], "userPic": "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTI3tbicwozMXHZkXLAWA9ZtichribdVMcy1uFmtBjibg9NYbGjYTpsj9dKiatq0Ta6icK6notrnv2GajbjA/132", "userView": 3 }, "shopInfo": { "goodsCount": 14, "logo": "https://img.58xfcs.com/49b6466d70b1512fcefb1f5bc4dad8b4", "saleNumber": 14, "shopAddress": "华士大酒店", "shopId": "876D436F39DE483BE053191EA8C075D0", "shopLatitude": "31.839454", "shopLongitude": "120.4668", "shopName": "king", "shopServiceTel": "123,56561456546456,45645646" }, "specInfo": { "goodsId": "F56AE9B3064E4DF583BFA296680CFCC9", "groupPrice": "0.01", "qty": "222", "saleNumber": "2", "singlePrice": "6", "specId": "B1DE410A45CE498894FF0084A122DD31", "specs": [ "2", "阿萨德", "222" ] } }, "resultcode": "0", "resultdesc": "success" }</code></pre> <p><strong>备注</strong> </p> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML