逛逛

逛逛App


发布商品

<p><strong>简要描述:</strong> </p> <ul> <li>发布商品</li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li><code>/v1/goods/release</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;">goods_cate_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>商品分类id</td> </tr> <tr> <td style="text-align: left;">game_type_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>普通商品为0,游戏商品为对应的game_type_id</td> </tr> <tr> <td style="text-align: left;">trade_type_id</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>交易类型id 如1陪玩 3租号</td> </tr> <tr> <td style="text-align: left;">goods_name</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商品名</td> </tr> <tr> <td style="text-align: left;">goods_desc</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商品描述</td> </tr> <tr> <td style="text-align: left;">goods_media[]</td> <td style="text-align: left;">是</td> <td style="text-align: left;">json</td> <td>媒体数据 例:{&quot;media_type&quot;:1,&quot;is_main&quot;:0,&quot;url&quot;:&quot;http:\/\/www.baidu.com/userid_123123_4_4_200.mp4&quot;,&quot;sort&quot;:10} 或 {&quot;media_id&quot;:1217,&quot;media_type&quot;:1,&quot;is_main&quot;:0,&quot;url&quot;:&quot;http:\/\/www.baidu.com/userid_12a66_3_4_100.mp4&quot;,&quot;sort&quot;:10}</td> </tr> <tr> <td style="text-align: left;">goods_detail_media[]</td> <td style="text-align: left;">否</td> <td style="text-align: left;">json</td> <td>详情媒体数据 例:{&quot;media_type&quot;:1,&quot;is_main&quot;:0,&quot;url&quot;:&quot;http:\/\/www.baidu.com/userid_123123_4_4_200.mp4&quot;,&quot;sort&quot;:10} 或 {&quot;media_id&quot;:1217,&quot;media_type&quot;:1,&quot;is_main&quot;:0,&quot;url&quot;:&quot;http:\/\/www.baidu.com/userid_12a66_3_4_100.mp4&quot;,&quot;sort&quot;:10}</td> </tr> <tr> <td style="text-align: left;">promotion_rate</td> <td style="text-align: left;">是</td> <td style="text-align: left;">float</td> <td>推广比例,精确到小数点后两位,不开启为0,最小值为0.1</td> </tr> <tr> <td style="text-align: left;">price</td> <td style="text-align: left;">是</td> <td style="text-align: left;">float</td> <td>价格最大值为100000,多规格商品填此字段无效</td> </tr> <tr> <td style="text-align: left;">goods_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>商品id,编辑商品时需要传这个字段</td> </tr> <tr> <td style="text-align: left;">delivery_type</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>发货类型,可选值1,2,3(1手动发货,2自动发货,3不需要发货) ,不可修改</td> </tr> <tr> <td style="text-align: left;">specs_type</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>规格类型,可选值1,2,3(1单规格,2多规格,3无规格) ,不可修改</td> </tr> <tr> <td style="text-align: left;">goods_options</td> <td style="text-align: left;">是</td> <td style="text-align: left;">json</td> <td>商品的参数,详见商品参数文档</td> </tr> <tr> <td style="text-align: left;">stock</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>商品库存,手动发货的单规格商品需要填写 ,其他都不需要填写</td> </tr> <tr> <td style="text-align: left;">game_coin</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>游戏币</td> </tr> <tr> <td style="text-align: left;">partition_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>区服id,没有传0 ,多个使用逗号分隔</td> </tr> <tr> <td style="text-align: left;">specs_data[]</td> <td style="text-align: left;">是</td> <td style="text-align: left;">json</td> <td>规格数据 例如:{&quot;goods_spec_id&quot;:41,&quot;spec_name&quot;:&quot;name666&quot;,&quot;spec_price&quot;:&quot;100.66&quot;,&quot;spec_stock&quot;:100}或 {&quot;game_coin&quot;:0,&quot;spec_name&quot;:&quot;1&quot;,&quot;spec_price&quot;:&quot;22.00&quot;,&quot;spec_stock&quot;:0,&quot;spec_desc&quot;:&quot;xxx&quot;}</td> </tr> <tr> <td style="text-align: left;">brief</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>商品简介 50字以内</td> </tr> <tr> <td style="text-align: left;">extra[order_time]</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>陪玩专用: 接单时间 例(0200-0300)</td> </tr> <tr> <td style="text-align: left;">extra[order_cycle]</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>陪玩专用: 接单周期 例(2,3为周2周三,7代表周日)</td> </tr> <tr> <td style="text-align: left;">extra[user_avatar]</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>陪玩专用: 头像,跟商品图片格式相同</td> </tr> <tr> <td style="text-align: left;">extra[user_sound_recording]</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>陪玩专用: 录音,跟商品视频格式相同</td> </tr> <tr> <td style="text-align: left;">extra[least_time]</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>租号专用:起租时长 单位h</td> </tr> <tr> <td style="text-align: left;">extra[deposit]</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>租号专用:押金</td> </tr> <tr> <td style="text-align: left;">extra[rent_case]</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>租号专用:租号计费方式:1时租收费 2固定时长</td> </tr> <tr> <td style="text-align: left;">extra[delay_hour]</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>租号专用:延迟上架:单位h 1,2,3,5,12,0;0表示手动</td> </tr> <tr> <td style="text-align: left;">extra[rent_plan][]</td> <td style="text-align: left;">否</td> <td style="text-align: left;">json</td> <td>租号专用:租金方案:如{&quot;hour&quot;:3,&quot;price&quot;:9.94,&quot;sort&quot;:1}</td> </tr> <tr> <td style="text-align: left;">extra[rent_type]</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>租号必传: 出租方式1单账号 2多账号</td> </tr> <tr> <td style="text-align: left;">extra[goods_descriptions][]</td> <td style="text-align: left;">否</td> <td style="text-align: left;">array</td> <td>商品详情描述 例如{&quot;goods_desc_id&quot;:2,&quot;desc_content&quot;:&quot;te2222222222222222222222st&quot;,&quot;desc_media&quot;:[{&quot;url&quot;:&quot;goods\/picture\/20191016\/126542_afcbcb4d90e8d22eae470e076ea72807_640_640_359.jpg&quot;,&quot;sort&quot;:1}],&quot;sort&quot;:1}</td> </tr> <tr> <td style="text-align: left;">first_buy_discount</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>首单折扣值</td> </tr> <tr> <td style="text-align: left;">feature</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>卖点-20200827新增字段</td> </tr> </tbody> </table> <p><strong>返回示例</strong></p> <pre><code>{ "code": 50702, "msg": "商品发布成功", "time": 1569573276, "data": { "goods_id": 1153, "pic": {//图片 "media_id": 1419, "url": "http://gg.kuaifaka.com//goods/picture/20190926/100002_adb24309d53a4b4ee5807f8344978e8c_750_1334_706.jpg", "width": "750.00", "height": "1334.00" }, "goods_name": "测试修改",//商品名 "goods_link": "http://www.baidu.com?user_id=100000&amp;goods_id=1153", "goods_qrcode": "http://192.168.3.243:86/v1/common/qrcode/make?data=http%3A%2F%2Fwww.baidu.com%3Fuser_id%3D100000%26goods_id%3D1153"//分享二维码 } }</code></pre> <pre><code>{ "code": 50701, "msg": "商品发布失败", "time": 1569295867, "data": {} }</code></pre> <p><strong>postman表单数据</strong></p> <pre><code>goods_cate_id:58 game_type_id:1001 sub_cate_id:0 goods_name:测试修改 goods_desc:测试修改 goods_media[]:{"media_id":1217,"media_type":1,"is_main":0,"url":"http:\/\/www.baidu.com/userid_12a66_3_4_100.mp4","sort":10} goods_media[]:{"media_type":1,"is_main":0,"url":"http:\/\/www.baidu.com/userid_123123_4_4_200.mp4","sort":10} promotion_rate:0.2 price:10 //goods_id:1043 delivery_type:1 specs_type:2 goods_options:{"media_type":1,"is_main":0,"url":"http:\/\/www.baidu.com/userid_123123_4_4_200.mp4","sort":10,"is_new":1} stock:100 specs_data[]:{"spec_name":"name666","spec_price":"100.66","game_coin": 9,"spec_stock":100} //specs_data[]:{"goods_spec_id":60,"spec_name":"name60","spec_price":"20","game_coin": 9,"spec_stock":555} //specs_data[]:{"spec_name":"name777","spec_price":"6.66","game_coin": 9,"spec_stock":555} extra[order_time]:0200-0300 extra[order_cycle]:2,3 extra[user_avatar]:http://www.baidu.com/userid_123123_4_4_200.mp4 extra[user_sound_recording]:http://www.baidu.com/userid_123123_4_4_200.mp4 //租号参数 extra[rent_case] :1 extra[delay_hour]:5 extra[rent_plan][]:{"hour":3,"price":9.94} extra[rent_plan][]:{"hour":4,"price":10.32} extra[rent_plan][]:{"hour":5,"price":13} extra[rent_type]:1 extra[deposit]:9 extra[least_time]:2 extra[goods_descriptions][]:{"goods_desc_id":2,"desc_content":"te2222222222222222222222st","desc_media":[{"url":"goods\/picture\/20191016\/126542_afcbcb4d90e8d22eae470e076ea72807_640_640_359.jpg","sort":1}],"sort":1} extra[goods_descriptions][]:{"goods_desc_id":3,"desc_content":"te2222222222222222222222st","desc_media":[{"url":"goods\/picture\/20191016\/126542_afcbcb4d90e8d22eae470e076ea72807_640_640_359.jpg","sort":1},{"url":"goods\/picture\/20191016\/126542_afcbcb4d90e8d22eae470e076ea72807_640_640_359.jpg","sort":1}],"sort":1}</code></pre> <p><strong>返回参数说明</strong> </p> <p><strong>备注</strong> </p> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul> <p>欢迎使用ShowDoc!</p>

页面列表

ITEM_HTML