淘寶API使用須知
淘寶聯(lián)盟設(shè)置使用螞蟻星球淘寶API需要先申請(qǐng)apikey并進(jìn)行淘寶授權(quán)，您可以螞蟻星球推廣中心->開發(fā)管理->插件接入查看apikey，單個(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)證語：螞蟻星球開放平臺(tái))
接口地址： http://api-gw.haojingke.com/index.php/v1/api/tb/getunionurl
支持格式： json
請(qǐng)求方式： get/post
請(qǐng)求示例： http://api-gw.haojingke.com/index.php/v1/api/tb/getunionurl?apikey=您的apikey&item_id=
請(qǐng)求參數(shù)說明：
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
| apikey | String | 是 | 螞蟻星球apikey，請(qǐng)將示例中的key替換成您的key |
| item_id | Integer | 是 | 寶貝ID（*必要） |
| pid | String | 是 | mm_0000_0000_000， 推廣位ID（可在開發(fā)者中心設(shè)置默認(rèn)pid）（*必要 需是授權(quán)淘寶號(hào)下的推廣位，如果請(qǐng)求的時(shí)候攜帶了渠道id請(qǐng)求，則該pid需是渠道管理下面的渠道專屬推廣位） |
| relation_id | String | 否 | 渠道ID |
| special_id | String | 否 | 會(huì)員運(yùn)營(yíng)ID |
| external_id | String | 否 | 淘寶客外部用戶標(biāo)記，如自身系統(tǒng)賬戶ID；微信ID等，需配合渠道接口（publisherget）獲取special_id， |
| xid（新） | String | 否 | 團(tuán)長(zhǎng)與下游渠道合作的特殊標(biāo)識(shí)，用于統(tǒng)計(jì)渠道推廣效果（*itemid、xid二選一 或 二選二） |
| get_tkl | String | 否 | 是否返回淘口令（0.否；1.是）（默認(rèn)0）（選填） |
| title | String | 否 | 淘口令標(biāo)題（用于返回淘口令*get_tkl等于1時(shí)為必填參數(shù)*，需超過8個(gè)字符） |
| logo | String | 否 | 淘口令彈窗的圖片 |
| positionid | Int | 否 | 自定義推廣位id，整型數(shù)字 (螞蟻星球開發(fā)者中心推廣位管理中的uid) |
JSON返回示例：
{
"data": {
"category_id": "1625",分類ID
"coupon_click_url": "https://uland.taobao.com/coupon/edetail?e=BT5m4kNPa%2B6lhHvvyUNXZfh8CuWt5YH5OVuOuRD5gLJMmdsrkidbOcgNAa9X6T79uG1ZaNECU%2FS28bztD9ZlyYv7WfPDvKbYXRuv7xpz1L7QEUCpE4O7Xc3und6mwXdKUqRUtTtZSji%2Bqi5RslGGce9tF5RNjUJqG%2Bsvhyg3hhpwdcbFHm9iHJFnYDcWDF2oMbGusFEnDH5i3DOS540Dp0CLoSLDztJNN9LVSIjIO7oqwPU18YFMoLjtdx6zVCzZH4P3zKhUcU02GOdIiNXzalVusqqnhify&traceId=0bb61b0c16182117715661915ef5f6&&union_lens=lensId:TAPI@1618211771@0b505cf6_087b_178c4f014cd_8025@01;linkRuleId:1",已轉(zhuǎn)鏈后的您的二合一鏈接（有券產(chǎn)品）或s.click鏈接（無券產(chǎn)品），可直接使用
"coupon_end_time": "2021-04-14",優(yōu)惠券過期時(shí)間 （有優(yōu)惠券時(shí)才有此字段）
"coupon_info": "滿19元減5元",優(yōu)惠券信息，格式都是“滿xx元減xx元”（有優(yōu)惠券時(shí)才有此字段）
"coupon_remain_count": "98000",剩余優(yōu)惠券數(shù)量，當(dāng)為0時(shí)優(yōu)惠券失效。（有優(yōu)惠券時(shí)才有此字段）
"coupon_start_time": "2021-04-12",優(yōu)惠券開始時(shí)間（有優(yōu)惠券時(shí)才有此字段）
"coupon_total_count": "100000",優(yōu)惠券發(fā)放總量 （有優(yōu)惠券時(shí)才有此字段）
"item_id": "580442138828",商品ID
"item_url": "https://detail.tmall.com/item.htm?id=580442138828",產(chǎn)品鏈接
"max_commission_rate": "20.06",常規(guī)傭金率：當(dāng)不入?yún)pecial_id、relation_id、external_id時(shí)，展示常規(guī)傭金率(%)
"reward_info": "0",比價(jià)場(chǎng)景專用，當(dāng)系統(tǒng)檢測(cè)到入?yún)⑾M(fèi)者ID購買當(dāng)前商品會(huì)獲得《天天開彩蛋》玩法的彩蛋時(shí)，該字段顯示1，否則為0
"cat_leaf_name": "短襪/打底襪/絲襪/美腿襪",分類子葉
"cat_name": "女士?jī)?nèi)衣/男士?jī)?nèi)衣/家居服",分類名
"nick": "bonas寶娜斯專賣店", 店鋪名稱
"num_iid": "580442138828",商品ID
"pict_url": "https://img.alicdn.com/bao/uploaded/i3/3162439037/O1CN01UaM8VD2Gczv0diNOn_!!0-item_pic.jpg",商品主圖
"presale_deposit": "0",預(yù)售商品-定金（元）
"presale_end_time": "0",預(yù)售商品-付定金結(jié)束時(shí)間（毫秒）
"presale_start_time": "0",預(yù)售商品-付定金開始時(shí)間（毫秒）
"presale_tail_end_time": "0",預(yù)售商品-付定金結(jié)束時(shí)間（毫秒）
"presale_tail_start_time": "0",預(yù)售商品-付尾款開始時(shí)間（毫秒）
"provcity": "浙江 金華",商品所在地
"reserve_price": "99",商品一口價(jià)格
"seller_id": "3162439037",賣家id
"small_images": { [
"https://img.alicdn.com/i2/3162439037/O1CN01OOSKtN2GczlKWg0Tn_!!3162439037.jpg",
"https://img.alicdn.com/i3/3162439037/O1CN01FdhGfq2Gczq0pbUGJ_!!3162439037-0-lubanu-s.jpg",
"https://img.alicdn.com/i3/3162439037/O1CN0166iB502GcznSLVfAT_!!3162439037.jpg",
"https://img.alicdn.com/i2/3162439037/O1CN01zsCNAd2Gczpt1fbDd_!!3162439037-0-lubanu-s.jpg"
]
},商品小圖列表
"superior_brand": "0",是否品牌精選，0不是，1是
"title": "肉色絲襪女薄款2020新款網(wǎng)紅黑絲連褲襪春秋款夏季光腿神器菠蘿襪",短鏈接
"tmall_play_activity_end_time": "0",天貓限時(shí)搶可售 -結(jié)束時(shí)間（毫秒）
"tmall_play_activity_start_time": "0",天貓限時(shí)搶可售 -開始時(shí)間（毫秒）
"user_type": "1",賣家類型，1、表示天貓，0、表示淘寶，3表示特價(jià)版
"volume": "190409",最近30天銷量
"zk_final_price": "19.9",產(chǎn)品折后價(jià)
"coupon_short_url": "https://s.click.taobao.com/awxzQpu",短鏈接
"ios_tbk_pwd": "8￥ue2gXc4PL6M￥ https://m.tb.cn/h.4pGp2tW 肉色絲襪女薄款2020新款網(wǎng)紅黑絲連褲襪春秋款夏季光腿神器菠蘿襪",針對(duì)聯(lián)盟2020-8-31新出的適用于IOS14的淘口令文案
"tbk_pwd": "￥ue2gXc4PL6M￥",淘口令，此口令是已轉(zhuǎn)化成你自己PID的口令
"tkl": "9(ue2gXc4PL6M) /" 蘋果IOS和安卓通用的簡(jiǎn)化淘口令?？商娲?tbk_pwd 和 ios_tbk_pwd
},
"message": "success",提示信息
"status_code": 200狀態(tài)碼 200表示請(qǐng)求成功
}
接口地址： http://api-gw.haojingke.com/index.php/v1/api/tb/activity
支持格式： json
請(qǐng)求方式： get/post
請(qǐng)求示例： http://api-gw.haojingke.com/index.php/v1/api/tb/activity?apikey=您的apikey&activity_id=
請(qǐng)求參數(shù)說明：
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
| apikey | String | 是 | 螞蟻星球apikey，請(qǐng)將示例中的key替換成您的key |
| activity_id | String | 是 | 官方活動(dòng)物料id |
| pid | String | 是 | mm_0000_0000_000， 推廣位ID（可在開發(fā)者中心設(shè)置默認(rèn)pid）（*必要 需是授權(quán)淘寶號(hào)下的推廣位，如果請(qǐng)求的時(shí)候攜帶了渠道id請(qǐng)求，則該pid需是渠道管理下面的渠道專屬推廣位） |
| relation_id | String | 否 | 渠道ID |
| union_id | String | 否 | 自定義輸入串，英文和數(shù)字組成，長(zhǎng)度不能大于12個(gè)字符，區(qū)分不同的推廣渠道 |
| get_tkl | String | 否 | 是否返回淘口令（0.否；1.是）（默認(rèn)0）（選填） |
| title | String | 否 | 淘口令標(biāo)題（用于返回淘口令*get_tkl等于1時(shí)為必填參數(shù)*，需超過8個(gè)字符） |
| logo | String | 否 | 淘口令彈窗的圖片 |
JSON返回示例：
{
"data": {
"click_url": "https://s.click.taobao.com/t?union_lens=lensId%3AMAPI%401618206678%402104ccc4_07d2_178c4a25e2a_7e33%4001%3BeventPageId%3A20150318020000462&e=m%3D2%26s%3DGPj1xpRhKgVw4vFB6t2Z2iperVdZeJviPI5Rhak06vZnX1vWUft3ZXCooVp%2Bhaq3%2BCItzojEYRP3HC9F1AE3cLIaDCBC%2F4E2GNMUGoCunc8TV3YQzXSFYdftwTU8qYAgsynDUllKeZHd0%2Bv22oF73US1A3RpE0wVDPxWoA2%2FDBPrMYvMaxVVKsK1DMtXGlsK08EP%2FnJs4K5AFEHVckI7b9XSpRlaJaElaJe2Xd4pkBlyeNAoQluSajK%2FmpnItMR0VaJBM3Fz6%2BgPTtU%2FdIEvWZRwfjTt4rjnSkKImelLej2UB7RP8CFvRlMb9ncl7geF8PwOkD4ulZdpYjsi4suCq9icWZOJx2fePm5r2egYQ0iiZ%2BQMlGz6FQ%3D%3D",鏈接
"material_oss_url": "http://creative-material-public.oss-cn-shanghai.aliyuncs.com/a/p/20150318020000462.zip",物料素材下載地址
"page_end_time": "2021-08-19",活動(dòng)結(jié)束時(shí)間
"page_name": "聚劃算百億補(bǔ)貼頁面",會(huì)場(chǎng)名稱
"page_start_time": "2020-09-16",活動(dòng)開始時(shí)間
"terminal_type": "2",投放平臺(tái)：1-PC，2-無線
"coupon_short_url": "https://s.click.taobao.com/BScELpu",短鏈
"ios_tbk_pwd": "3.0￥QdhgXcV9dnZ￥ https://m.tb.cn/h.4ptF0dY 點(diǎn)擊“打開”查看并瀏覽頁面詳情，精選商品任您選購",針對(duì)聯(lián)盟2020-8-31新出的適用于IOS14的淘口令文案
"tbk_pwd": "￥QdhgXcV9dnZ￥",淘口令，此口令是已轉(zhuǎn)化成你自己PID的口令
"tkl": "8(QdhgXcV9dnZ) /"蘋果IOS和安卓通用的簡(jiǎn)化淘口令?？商娲?tbk_pwd 和 ios_tbk_pwd
},
"message": "success",提示信息
"status_code": 200狀態(tài)碼 200表示請(qǐng)求成功
}
接口地址： http://api-gw.haojingke.com/index.php/v1/api/tb/shop
支持格式： json
請(qǐng)求方式： get/post
請(qǐng)求示例： http://api-gw.haojingke.com/index.php/v1/api/tb/shop?apikey=您的apikey&user_id=
請(qǐng)求參數(shù)說明：
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
| apikey | String | 是 | 螞蟻星球apikey，請(qǐng)將示例中的key替換成您的key |
| user_id | String | 是 | 賣家ID串，用','分割 |
| pid | String | 是 | mm_0000_0000_000， 推廣位ID（可在開發(fā)者中心設(shè)置默認(rèn)pid）（*必要 需是授權(quán)淘寶號(hào)下的推廣位，如果請(qǐng)求的時(shí)候攜帶了渠道id請(qǐng)求，則該pid需是渠道管理下面的渠道專屬推廣位） |
| relation_id | String | 否 | 渠道ID |
| union_id | String | 否 | 自定義輸入串，英文和數(shù)字組成，長(zhǎng)度不能大于12個(gè)字符，區(qū)分不同的推廣渠道 |
| get_tkl | String | 否 | 是否返回淘口令（0.否；1.是）（默認(rèn)0）（選填） |
| title | String | 否 | 淘口令標(biāo)題（用于返回淘口令*get_tkl等于1時(shí)為必填參數(shù)*，需超過8個(gè)字符） |
| logo | String | 否 | 淘口令彈窗的圖片 |
JSON返回示例：
{
"data": {
"click_url": "https://s.click.taobao.com/t?e=m%3D2%26s%3DSRD5KSEVZ0Bw4vFB6t2Z2jAVflQIoZepyK8Cckff7TVRAdhuF14FMfGUfXy3ofD5t4hWD5k2kjO3bcmU2DXU%2FuW76gk5BrvMBXTcnbeNW6f8VNjy6FCpN0m4argXYs%2F4Ke3%2FbelnU7eOJ4hmg2sGJDMrRWVrG%2F%2BL3rfiG8%2Bae61A8ZU6Y7TB%2FigSDy28JSWhQIAW7b5xhq7GDmntuH4VtA%3D%3D&union_lens=lensId:TAPI@1618213923@2105de0e_37d2_178c510ec00_8dc1@01",
"user_id": "3162439037",賣家id
"ios_tbk_pwd": "6￥DfwXXc4xFqw￥ https://m.tb.cn/h.4LVFUqR bonas寶娜斯專賣店",針對(duì)聯(lián)盟2020-8-31新出的適用于IOS14的淘口令文案
"tbk_pwd": "￥DfwXXc4xFqw￥",淘口令，此口令是已轉(zhuǎn)化成你自己PID的口令
"tkl": "0(DfwXXc4xFqw) /",蘋果IOS和安卓通用的簡(jiǎn)化淘口令?？商娲?tbk_pwd 和 ios_tbk_pwd
"coupon_short_url": "https://s.click.taobao.com/iK6vQpu"短鏈
},
"message": "success",提示信息
"status_code": 200狀態(tài)碼 200表示請(qǐng)求成功
}
