唯品會(huì)API使用須知
唯品會(huì)聯(lián)盟設(shè)置螞蟻星球推出開放API的目的在于，讓具有開發(fā)能力的個(gè)人京東客，開發(fā)團(tuán)隊(duì)以及軟件開發(fā)商更便捷的采集螞蟻星球商品庫(kù)的數(shù)據(jù)，實(shí)現(xiàn)優(yōu)質(zhì)好單的資源共享。使用螞蟻星球開放API需要先申請(qǐng)apikey，您可以在本頁(yè)面上方點(diǎn)擊申請(qǐng)按鈕或直接進(jìn)入個(gè)人中心開放API頁(yè)面申請(qǐng)，單個(gè)螞蟻星球賬號(hào)只能申請(qǐng)一個(gè)apikey。螞蟻星球開放API是免費(fèi)使用的，但螞蟻星球保留對(duì)各接口進(jìn)行調(diào)整的權(quán)利，我們會(huì)在調(diào)整時(shí)及時(shí)給予通知，也請(qǐng)您持續(xù)關(guān)注我們的公告。
聯(lián)系技術(shù)支持：712218340 點(diǎn)擊鏈接加入群聊【官方API交流群】(驗(yàn)證語(yǔ)：螞蟻星球開放平臺(tái))
接口地址：
http://api-gw.haojingke.com/index.php/v1/api/vip/goodslist
官方文檔
支持格式： json
請(qǐng)求方式： get/post
請(qǐng)求示例： http://api-gw.haojingke.com/index.php/v1/api/vip/goodslist?apikey=您的apikey&pageindex=1&pagesize=20
請(qǐng)求參數(shù)說(shuō)明：
| 名稱 | 類型 | 必填 | 說(shuō)明 |
|---|---|---|---|
| apikey | String | 是 | 螞蟻星球apikey，請(qǐng)將示例中的key替換成您的key |
| pageindex | Integer | 否 | 第幾頁(yè)（默認(rèn)第1頁(yè)） |
| pagesize | Integer | 否 | 10-100 默認(rèn)20 |
| channelType | Integer | 否 | 頻道類型:0-超高傭，1-出單爆款; 當(dāng)請(qǐng)求類型為頻道時(shí)必傳 |
| sourceType | Integer | 否 | 請(qǐng)求源類型：0-頻道，1-組貨 |
| jxCode | String | 否 | 精選組貨碼：當(dāng)請(qǐng)求源類型為組貨時(shí)必傳 女裝精選 7hfpy0m4,男裝精選 wj7evz2j,美妝精選 vd0wbfdx,數(shù)碼電子 dpot8m5u,精選-首飾 szkl4kj7,鞋包精選 byh9331t,母嬰精選 gkf52p8p,居家精選 cnrzcs22,運(yùn)動(dòng)戶外精選 indvf44e,家用電器 uggxpyh5 |
| fieldName | String | 否 | 排序字段: COMMISSION-傭金，PRICE-價(jià)格,COMM_RATIO-傭金比例，DISCOUNT-折扣 |
| order | Integer | 否 | 排序順序：0-正序，1-逆序，默認(rèn)正序 |
JSON返回示例：
{
"data": {
"goodsInfoList": [
{
"goodsId": "2165850533",商品ID
"goodsName": "【搶！紅包減￥50】薰衣草潔凈洗衣液耐用半年機(jī)洗手洗",商品名稱
"goodsDesc": null,商品描述,字段暫不輸出
"destUrl": "https://m.vip.com/product-3495916-2165850533.html",商品鏈接
"goodsThumbUrl": "https://a.vpimg4.com/upload/merchandise/pdcpos/1100001647/2020/0921/153/cd0b3122-6c5e-49a5-b023-a4867d34686d_750x750_50.jpg",縮略圖
"goodsCarouselPictures": null,商品輪播圖：根據(jù)商品id查詢時(shí)返回，商品列表不返回
"goodsMainPicture": "https://a.vpimg2.com/upload/merchandise/pdcpos/1100001647/2020/0921/153/cd0b3122-6c5e-49a5-b023-a4867d34686d.jpg",主圖
"categoryId": 390774,商品三級(jí)分類id
"categoryName": "洗衣液",商品三級(jí)分類
"sourceType": 1,商品類型：0-自營(yíng)，1-MP
"marketPrice": "456.00",市場(chǎng)價(jià)（元）
"vipPrice": "113.00",唯品價(jià)（元）
"commissionRate": "20.5",傭金比例（%）
"commission": "23.17",傭金金額（元）
"discount": "0.25",折扣:唯品價(jià)/市場(chǎng)價(jià) 保留兩位小數(shù)字符串
"goodsDetailPictures": null,商品詳情圖片：根據(jù)商品id查詢商品信息時(shí)返回，商品列表不返回
"cat1stId": 517,商品一級(jí)分類id
"cat1stName": "日用家居",商品一級(jí)分類名稱
"cat2ndId": 73911,商品二級(jí)分類id
"cat2ndName": "家清日化",商品二級(jí)分類名稱
"brandStoreSn": "10028135",商品品牌sn
"brandName": "藍(lán)月亮",商品品牌名稱
"brandLogoFull": "http://a.vpimg3.com/upload/brandcool/0/7e4e61ac2071401393ed39f04b41704e/10028135/primary.png",商品品牌logo全路徑地址
"schemeEndTime": 1600703999000,商品推廣計(jì)劃有效期預(yù)估截止時(shí)間：僅為預(yù)估時(shí)間，僅做參考；時(shí)間戳，單位：毫秒
"sellTimeFrom": 1535964934000,商品售賣開始時(shí)間,時(shí)間戳，單位毫秒
"sellTimeTo": 2145888000000,商品售賣結(jié)束時(shí)間,時(shí)間戳, 單位毫秒
"weight": null,推廣權(quán)重，用于確定推廣該商品的優(yōu)先級(jí)，權(quán)重值越大，優(yōu)先級(jí)越高
"storeInfo": {店鋪信息
"storeId": "ST95405891",店鋪ID
"storeName": "藍(lán)月亮官方旗艦店"店鋪名稱
},
"commentsInfo": {商品評(píng)價(jià)信息
"comments": 0,商品評(píng)論數(shù)
"goodCommentsShare": null商品好評(píng)率:百分比，不帶百分號(hào)
},
"storeServiceCapability": {商品所屬店鋪服務(wù)能力評(píng)價(jià)
"storeScore": "88.94",店鋪評(píng)分：保留兩位小數(shù)
"storeRankRate": "7.0000"店鋪同品類排名比例：例如10表示前10%
},
"brandId": 3495916,商品所屬檔期（專場(chǎng)）id
"schemeStartTime": 1600358400000,商品所屬推廣方案開始時(shí)間：時(shí)間戳，單位：毫秒
"saleStockStatus": 2,商品庫(kù)存狀態(tài)：1-已搶光，2-有庫(kù)存，3-有機(jī)會(huì),當(dāng)列表查詢庫(kù)存或者查詢商品詳情時(shí)返回
"status": 1,商品狀態(tài)：0-下架，1-上架
"prepayInfo": {商品預(yù)付信息
"isPrepay": 0,是否預(yù)付商品:0-否，1-是
"prepayPrice": null,預(yù)付到手價(jià)：元
"firstAmount": null,預(yù)付首款金額：元
"lastAmount": null,預(yù)付尾款金額：元
"prepayFavAmount": null,預(yù)付優(yōu)惠金額: 元
"deductionPrice": null,抵扣價(jià)格(首款+優(yōu)惠金額)：元
"prepayDiscount": null,預(yù)付折扣：(唯品價(jià)-優(yōu)惠金額)/唯品價(jià) 保留兩位小數(shù)的數(shù)字字符串
"prepayFirstStartTime": null,首款支付開始時(shí)間:時(shí)間戳,單位毫秒
"prepayFirstEndTime": null,首款支付結(jié)束時(shí)間:時(shí)間戳,單位毫秒
"prepayLastStartTime": null,尾款支付開始時(shí)間:時(shí)間戳,單位毫秒
"prepayLastEndTime": null尾款支付結(jié)束時(shí)間:時(shí)間戳,單位毫秒
},
"joinedActivities": null,商品參與活動(dòng)信息:未參與活動(dòng)集合為空
"couponInfo": {優(yōu)惠券批次號(hào)
"couponNo": "743056",優(yōu)惠劵名稱
"couponName": "921-925-機(jī)洗手洗9斤-200-108元紅包",使用門檻
"buy": "200.00",優(yōu)惠金額
"fav": "108.00",券激活開始時(shí)間,毫秒級(jí)時(shí)間戳
"activateBeginTime": 1600653600000,券激活開始時(shí)間,毫秒級(jí)時(shí)間戳
"activateEndTime": 1600999200000,券激活結(jié)束時(shí)間，毫秒級(jí)時(shí)間戳
"useBeginTime": 1600653601000,使用開始時(shí)間，毫秒級(jí)時(shí)間戳
"useEndTime": 1600999200000,使用結(jié)束時(shí)間，毫秒級(jí)時(shí)間戳
"totalAmount": 10000,生成劵的總量
"activedAmount": 475劵已激活的數(shù)量
},
"haiTao": 0是否海淘商品標(biāo)識(shí)：1是 0不是
}
],
"total": 44總數(shù)
},
"message": "success",提示信息
"status_code": 200狀態(tài)碼 200表示請(qǐng)求成功
}
接口地址：
http://api-gw.haojingke.com/index.php/v1/api/vip/goodsquery
官方文檔
支持格式： json
請(qǐng)求方式： get/post
請(qǐng)求示例： http://api-gw.haojingke.com/index.php/v1/api/vip/goodsquery?apikey=您的apikey&pageindex=1&pagesize=20&keyword=手機(jī)
請(qǐng)求參數(shù)說(shuō)明：
| 名稱 | 類型 | 必填 | 說(shuō)明 |
|---|---|---|---|
| apikey | String | 是 | 螞蟻星球apikey，請(qǐng)將示例中的key替換成您的key |
| pageindex | Integer | 否 | 第幾頁(yè)（默認(rèn)第1頁(yè)） |
| pagesize | Integer | 否 | 10-100 默認(rèn)20 |
| keyword | String | 是 | 關(guān)鍵詞 |
| priceStart | String | 否 | 價(jià)格區(qū)間---start |
| priceEnd | String | 否 | 價(jià)格區(qū)間---end |
| fieldName | String | 否 | 排序字段: COMMISSION-傭金，PRICE-價(jià)格,COMM_RATIO-傭金比例，DISCOUNT-折扣 |
| order | Integer | 否 | 排序順序：0-正序，1-逆序，默認(rèn)正序 |
JSON返回示例：
{
"data": {
"goodsInfoList": [
{
"goodsId": "2165850533",商品ID
"goodsName": "【搶！紅包減￥50】薰衣草潔凈洗衣液耐用半年機(jī)洗手洗",商品名稱
"goodsDesc": null,商品描述,字段暫不輸出
"destUrl": "https://m.vip.com/product-3495916-2165850533.html",商品鏈接
"goodsThumbUrl": "https://a.vpimg4.com/upload/merchandise/pdcpos/1100001647/2020/0921/153/cd0b3122-6c5e-49a5-b023-a4867d34686d_750x750_50.jpg",縮略圖
"goodsCarouselPictures": null,商品輪播圖：根據(jù)商品id查詢時(shí)返回，商品列表不返回
"goodsMainPicture": "https://a.vpimg2.com/upload/merchandise/pdcpos/1100001647/2020/0921/153/cd0b3122-6c5e-49a5-b023-a4867d34686d.jpg",主圖
"categoryId": 390774,商品三級(jí)分類id
"categoryName": "洗衣液",商品三級(jí)分類
"sourceType": 1,商品類型：0-自營(yíng)，1-MP
"marketPrice": "456.00",市場(chǎng)價(jià)（元）
"vipPrice": "113.00",唯品價(jià)（元）
"commissionRate": "20.5",傭金比例（%）
"commission": "23.17",傭金金額（元）
"discount": "0.25",折扣:唯品價(jià)/市場(chǎng)價(jià) 保留兩位小數(shù)字符串
"goodsDetailPictures": null,商品詳情圖片：根據(jù)商品id查詢商品信息時(shí)返回，商品列表不返回
"cat1stId": 517,商品一級(jí)分類id
"cat1stName": "日用家居",商品一級(jí)分類名稱
"cat2ndId": 73911,商品二級(jí)分類id
"cat2ndName": "家清日化",商品二級(jí)分類名稱
"brandStoreSn": "10028135",商品品牌sn
"brandName": "藍(lán)月亮",商品品牌名稱
"brandLogoFull": "http://a.vpimg3.com/upload/brandcool/0/7e4e61ac2071401393ed39f04b41704e/10028135/primary.png",商品品牌logo全路徑地址
"schemeEndTime": 1600703999000,商品推廣計(jì)劃有效期預(yù)估截止時(shí)間：僅為預(yù)估時(shí)間，僅做參考；時(shí)間戳，單位：毫秒
"sellTimeFrom": 1535964934000,商品售賣開始時(shí)間,時(shí)間戳，單位毫秒
"sellTimeTo": 2145888000000,商品售賣結(jié)束時(shí)間,時(shí)間戳, 單位毫秒
"weight": null,推廣權(quán)重，用于確定推廣該商品的優(yōu)先級(jí)，權(quán)重值越大，優(yōu)先級(jí)越高
"storeInfo": {店鋪信息
"storeId": "ST95405891",店鋪ID
"storeName": "藍(lán)月亮官方旗艦店"店鋪名稱
},
"commentsInfo": {商品評(píng)價(jià)信息
"comments": 0,商品評(píng)論數(shù)
"goodCommentsShare": null商品好評(píng)率:百分比，不帶百分號(hào)
},
"storeServiceCapability": {商品所屬店鋪服務(wù)能力評(píng)價(jià)
"storeScore": "88.94",店鋪評(píng)分：保留兩位小數(shù)
"storeRankRate": "7.0000"店鋪同品類排名比例：例如10表示前10%
},
"brandId": 3495916,商品所屬檔期（專場(chǎng)）id
"schemeStartTime": 1600358400000,商品所屬推廣方案開始時(shí)間：時(shí)間戳，單位：毫秒
"saleStockStatus": 2,商品庫(kù)存狀態(tài)：1-已搶光，2-有庫(kù)存，3-有機(jī)會(huì),當(dāng)列表查詢庫(kù)存或者查詢商品詳情時(shí)返回
"status": 1,商品狀態(tài)：0-下架，1-上架
"prepayInfo": {商品預(yù)付信息
"isPrepay": 0,是否預(yù)付商品:0-否，1-是
"prepayPrice": null,預(yù)付到手價(jià)：元
"firstAmount": null,預(yù)付首款金額：元
"lastAmount": null,預(yù)付尾款金額：元
"prepayFavAmount": null,預(yù)付優(yōu)惠金額: 元
"deductionPrice": null,抵扣價(jià)格(首款+優(yōu)惠金額)：元
"prepayDiscount": null,預(yù)付折扣：(唯品價(jià)-優(yōu)惠金額)/唯品價(jià) 保留兩位小數(shù)的數(shù)字字符串
"prepayFirstStartTime": null,首款支付開始時(shí)間:時(shí)間戳,單位毫秒
"prepayFirstEndTime": null,首款支付結(jié)束時(shí)間:時(shí)間戳,單位毫秒
"prepayLastStartTime": null,尾款支付開始時(shí)間:時(shí)間戳,單位毫秒
"prepayLastEndTime": null尾款支付結(jié)束時(shí)間:時(shí)間戳,單位毫秒
},
"joinedActivities": null,商品參與活動(dòng)信息:未參與活動(dòng)集合為空
"couponInfo": {優(yōu)惠券批次號(hào)
"couponNo": "743056",優(yōu)惠劵名稱
"couponName": "921-925-機(jī)洗手洗9斤-200-108元紅包",使用門檻
"buy": "200.00",優(yōu)惠金額
"fav": "108.00",券激活開始時(shí)間,毫秒級(jí)時(shí)間戳
"activateBeginTime": 1600653600000,券激活開始時(shí)間,毫秒級(jí)時(shí)間戳
"activateEndTime": 1600999200000,券激活結(jié)束時(shí)間，毫秒級(jí)時(shí)間戳
"useBeginTime": 1600653601000,使用開始時(shí)間，毫秒級(jí)時(shí)間戳
"useEndTime": 1600999200000,使用結(jié)束時(shí)間，毫秒級(jí)時(shí)間戳
"totalAmount": 10000,生成劵的總量
"activedAmount": 475劵已激活的數(shù)量
},
"haiTao": 0是否海淘商品標(biāo)識(shí)：1是 0不是
}
],
"total": 44總數(shù)
},
"message": "success",提示信息
"status_code": 200狀態(tài)碼 200表示請(qǐng)求成功
}