商品详情
<p><strong>简要描述:</strong> </p>
<ul>
<li>支持淘、京、拼三大平台</li>
<li>做返利模式需要接阿里百川的“百川电商SDK”,让APP用户进行淘宝授权</li>
<li>做返利模式的客户端技术同学请注意,用户在商品详情页点击领券购买按钮时要判断用户的登录情况,未登录状态需跳转到登录页面,登录状态才打开授权链接</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>/api/goods/detail</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>Get</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;">item_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商品ID</td>
</tr>
<tr>
<td style="text-align: left;">mall_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>商城 1:淘宝 2.天猫 3.拼多多 4.京东</td>
</tr>
<tr>
<td style="text-align: left;">activity_id</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>优惠券ID</td>
</tr>
</tbody>
</table>
<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;">multi_group</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">boolean</td>
<td>true:多人团推广链接 false:单人团推广链接, 默认false</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
"code": "0",
"msg": "返回成功",
"data": {
"item_id": "3641879797",
"title": "简诺正宗土鸡蛋农家散养新鲜30枚天然纯农村柴鸡蛋草鸡蛋",
"recommend": "简诺正宗土鸡蛋农家散养新鲜30枚天然纯农村柴鸡蛋草鸡蛋",
"price": "12.90",
"month_sales": "3.6万",
"cover_image": "https://t00img.yangkeduo.com/goods/images/2018-10-24/c9ac4c28fefe7abefd292f9c0e4a0381.jpeg",
"mall_id": 3,
"activity_type": 1,
"tk_rate": 20,
"shop_name": "斯维因水果生鲜",
"images": [
"https://t00img.yangkeduo.com/goods/images/2018-10-24/15028bfd568beffb59971c787399fbdc.jpeg",
"https://t00img.yangkeduo.com/goods/images/2018-10-24/7ad880db545a3a6b324850c93f950ccd.jpeg",
"https://t00img.yangkeduo.com/goods/images/2018-10-24/4d6c644aea9559d02948a5f4e790238a.jpeg",
"https://t00img.yangkeduo.com/goods/images/2018-10-24/f9250c4acff329a103c8b0402a9072bb.jpeg"
],
"detail_images": [],
"dsr_info": {
"descriptionMatch": 4.7,
"serviceAttitude": 4.7,
"deliverySpeed": 4.7
},
"tkl": "",
"mall_icon": "https://img.daff9.cn/xidian/static/pin.png",
"coupon_money": "6.00",
"discount_price": "6.90",
"fl_commission": "赚0.43",
"fl_commission_amount": 43,
"activity_id": "",
"coupon_explain_money": "",
"coupon_starttime": "2019-05-30 00:00:00",
"coupon_endtime": "2019-06-30 23:59:59",
"coupon_click_url": "https://mobile.yangkeduo.com/app.html?launch_url=duo_coupon_landing.html%3Fgoods_id%3D3641879797%26pid%3D1001496_52090526%26authDuoId%3D1031777%26cpsSign%3DCC_190530_1001496_52090526_3d7dac6010732ba6ecf960a36caf491c%26duoduo_type%3D2",
"need_oauth": true,
"oauth_url": "http://www.biyingniao.com/oauth/taobao xxxx",
"presale_deposit": 0,
"presale_discount_fee_text": "",
"presale_end_time": "",
"presale_start_time": "",
"presale_tail_end_time": "",
"presale_tail_start_time": "",
"detail_web_url": "https://mdetail.tmall.com/templates/pages/desc?id=599977932601",
"shop_logo": "https//img.alicdn.com/imgextra//c9/a1/TB1HG6RsVuWBuNjSspnSut1NVXa.jpg",
"deeplink": "",
//小程序信息,仅拼多多,京东 有返回值
"we_app_info": {
"we_app_icon_url": "http://xcxcdn.yangkeduo.com/pdd_logo.png",
"user_name": "gh_0e7477744313@app",
"page_path": "package_a/welfare_coupon/welfare_coupon?goods_id=8131538384&pid=8629219_102239210&customParameters=%7B%22t-v-f-s-p%22%3A%220-0-5-1-openapp_locale%22%7D&authDuoId=1031777&cpsSign=CC_191202_8629219_102239210_51f24e9ce05ee998a8f38c5615aa7960&duoduo_type=2",
"banner_url": null,
"source_display_name": "拼多多",
"title": "小苏打水果按压式液体牙膏美白去黄口臭去渍牙刷家庭装批发220克",
"app_id": "wx32540bd863b27570",
"desc": "拼多多,多实惠,多乐趣。"
}
}
}</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名称</th>
<th style="text-align: left;">参数描述</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">item_id</td>
<td style="text-align: left;">商品ID</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">title</td>
<td style="text-align: left;">商品标题</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">recommend</td>
<td style="text-align: left;">推荐理由</td>
<td>string</td>
<td>可为空</td>
</tr>
<tr>
<td style="text-align: left;">coupon_money</td>
<td style="text-align: left;">优惠券面值</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">coupon_explain_money</td>
<td style="text-align: left;">优惠券限制</td>
<td>string</td>
<td>满x元可用</td>
</tr>
<tr>
<td style="text-align: left;">activity_id</td>
<td style="text-align: left;">优惠券ID</td>
<td>string</td>
<td>可为空</td>
</tr>
<tr>
<td style="text-align: left;">cover_image</td>
<td style="text-align: left;">商品主图</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">month_sales</td>
<td style="text-align: left;">月销量</td>
<td>int</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">price</td>
<td style="text-align: left;">商品原价</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">is_collect</td>
<td style="text-align: left;">商品是否已被收藏</td>
<td>bool</td>
<td>true-已收藏;false-未收藏</td>
</tr>
<tr>
<td style="text-align: left;">discount_price</td>
<td style="text-align: left;">商品券后价</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">tk_rate</td>
<td style="text-align: left;">佣金比</td>
<td>float</td>
<td>单位:%</td>
</tr>
<tr>
<td style="text-align: left;">fl_commission</td>
<td style="text-align: left;">返利金额</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">fl_commission_amount</td>
<td style="text-align: left;">返利金额</td>
<td>string</td>
<td>单位:分</td>
</tr>
<tr>
<td style="text-align: left;">shop_name</td>
<td style="text-align: left;">店铺名称</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">activity_type</td>
<td style="text-align: left;">商品类型</td>
<td>int</td>
<td>1-普通 2-淘抢购 3-聚划算</td>
</tr>
<tr>
<td style="text-align: left;">images</td>
<td style="text-align: left;">商品附图</td>
<td>array</td>
<td>图片地址数组</td>
</tr>
<tr>
<td style="text-align: left;">coupon_click_url</td>
<td style="text-align: left;">领券下单地址</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">coupon_starttime</td>
<td style="text-align: left;">优惠券开始使用时间</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">coupon_endtime</td>
<td style="text-align: left;">优惠券结束使用时间</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">dsr_info</td>
<td style="text-align: left;">商品dsr评分</td>
<td>object</td>
<td>可为空</td>
</tr>
<tr>
<td style="text-align: left;">mall_id</td>
<td style="text-align: left;">平台类型</td>
<td>int</td>
<td>1-淘宝 2-天猫 3-拼多多 4-京东</td>
</tr>
<tr>
<td style="text-align: left;">mall_icon</td>
<td style="text-align: left;">平台logo</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">shop_logo</td>
<td style="text-align: left;">店铺logo</td>
<td>string</td>
<td>京东/拼多多暂无店铺logo,将统一返回平台logo</td>
</tr>
<tr>
<td style="text-align: left;">deeplink</td>
<td style="text-align: left;">schema跳转链接</td>
<td>string</td>
<td>淘京拼都会返回对应的schema链接</td>
</tr>
</tbody>
</table>
<p><strong>以下参数仅淘宝/天猫平台有返回值</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名称</th>
<th style="text-align: left;">参数描述</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">tkl</td>
<td style="text-align: left;">淘口令</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">need_oauth</td>
<td style="text-align: left;">是否需要唤起淘宝授权</td>
<td>boolean</td>
<td>true-需要授权</td>
</tr>
<tr>
<td style="text-align: left;">oauth_url</td>
<td style="text-align: left;">授权h5地址</td>
<td>string</td>
<td>授权链接</td>
</tr>
<tr>
<td style="text-align: left;">detail_images</td>
<td style="text-align: left;">商品详情图</td>
<td>array</td>
<td>可为空</td>
</tr>
<tr>
<td style="text-align: left;">detail_web_url</td>
<td style="text-align: left;">商品详情图链接</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">presale_deposit</td>
<td style="text-align: left;">定金金额</td>
<td>string</td>
<td>仅双十一大促期间有效</td>
</tr>
<tr>
<td style="text-align: left;">presale_discount_fee_text</td>
<td style="text-align: left;">商品优惠信息</td>
<td>string</td>
<td>仅双十一大促期间有效</td>
</tr>
<tr>
<td style="text-align: left;">presale_start_time</td>
<td style="text-align: left;">付定金开始时间</td>
<td>int</td>
<td>单位:毫秒,仅双十一大促期间有效</td>
</tr>
<tr>
<td style="text-align: left;">presale_end_time</td>
<td style="text-align: left;">付定金结束时间</td>
<td>int</td>
<td>单位:毫秒,仅双十一大促期间有效</td>
</tr>
<tr>
<td style="text-align: left;">presale_tail_start_time</td>
<td style="text-align: left;">付尾款开始时间</td>
<td>int</td>
<td>单位:毫秒,仅双十一大促期间有效</td>
</tr>
<tr>
<td style="text-align: left;">presale_tail_end_time</td>
<td style="text-align: left;">付尾款结束时间</td>
<td>int</td>
<td>单位:毫秒,仅双十一大促期间有效</td>
</tr>
</tbody>
</table>
<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;">we_app_info</td>
<td style="text-align: left;">微信小程序信息</td>
<td>array</td>
</tr>
<tr>
<td style="text-align: left;">-we_app_icon_url</td>
<td style="text-align: left;">信息①小程序图片</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">-user_name</td>
<td style="text-align: left;">信息②用户名</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">-page_path</td>
<td style="text-align: left;">信息③小程序路径</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">-banner_url</td>
<td style="text-align: left;">信息④Banner图</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">-source_display_name</td>
<td style="text-align: left;">信息⑤来源名</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">-app_id</td>
<td style="text-align: left;">信息⑥拼多多小程序id</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">-desc</td>
<td style="text-align: left;">信息⑦描述</td>
<td>string</td>
</tr>
</tbody>
</table>
<p><strong>错误码说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">错误码</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">10001</td>
<td>PID配置有误</td>
</tr>
<tr>
<td style="text-align: left;">10002</td>
<td>淘宝授权信息有误或者过期,请确认授权是否正确</td>
</tr>
<tr>
<td style="text-align: left;">10003</td>
<td>该商品已下架(退出淘宝客推广)</td>
</tr>
<tr>
<td style="text-align: left;">10004</td>
<td>该商品已下架(授权掉线或者商品下架)</td>
</tr>
</tbody>
</table>