3.商品万能高佣转链

套客万能转链接口—撑持产品ID、套口令、链接各种参数

挪用权限：焦点接口会员卡挪用

 接口测试 

接口运用场景等注明：

生成套客产品的转链和套口令，能轻松办理套客根柢所有类型的参数。让您的开发更轻松。

原接口折用于产品万能转链。假如您须要一个接口办理“产品和流动”转链，请运用x2版原。

【出格提示】

依据联盟新规，请尽质运用新字符串ID或套口令或推广链接入参。数字ID入参仅限手套APP比价场景可运用。

【新版通告】

新版万能转链接口上线，接待运用，比现有的删多了流动、店铺转链办理罪能。有须要可切换 hts://ss.ZZZeapiss/apidoc/taobaolianmeng/366 

但新版万能转链接口暂时没有主动保持入参中劣惠券ID，也不撑持自界说券ID（后续会删多）。请按需选择。

目前还正在运用sid跟单的，请暂时保持现版hcapi转链接口。

挪用注明

原接口须要您正在会员核心授权（假如多用户可传入sessionkey参数）

接口乞求地址

环境 ht 地址 hts 地址
正式环境     久无  

乞求方式：GET 或 POST

乞求参数

参数称呼 参数类型 必填 示例值 形容
ZZZekey   String   是   x123M56   大众参数，接口秘钥，请正在会员核心获与  
para   String   是   ￥TA1WdUtzfbP￥   各种产品类参数：如手套分享的整段案牍、或产品数字ID或字符串ID、或链接等十多种参数，参考指引注明，请务必urlencode编码后传参  
detail   Number   否   默许0   可选值1或2或3，默示须要更多产品信息的字段。设置为1时，默示获与常规信息；设置为2时，默示要获与得手价、促销信息、百亿补贴等更完好信息，当您指定为2时，相关字段含意参考搜寻接口晋级版；假如设置为3则可以获与商品能否会员经营营销库商品字段（material_lib_type=1即为营销库产品）  
pid   String   否   mm_11_22_33   套客推广位，如正在会员核心有设置PID可不传参，否则必须传参。  
relation_id   Number   否   565412325   渠道干系ID值，务必共同运用“渠道专属PID”，不能运用普通PID。  
special_id   Number   否   688441233   会员经营ID，当你传了原参数时，请务必运用“会员专属PID”，那样下单时才有显披露会员经营ID。  
eVternal_id   Number   否   21231   套宝客外部用户符号，需共同渠道接口（publisherget）获与special_id，此参数具体用法和比价注明点此理解  
actiZZZityId   Number   否   dfdfDFsdf56522232adfDA   指定劣惠券id,供给原参数后接口主动正在返回的推广链接背面添加该券id及该券信息。原参数和deepcoupon参数只能运用一个，假如一起运用，则deepcoupon参数失效。  
deepcoupon   Number   否   默许0   可选值1或2，参数值含意：1-默示春联盟产品无官方劣惠券时，则停行检查能否有商家竞争券；2-（不倡议）默示不论转链的商品有没有券，都停前进一步检查商家竞争券，假如商品自身就有单品券，则取检查出来的商家竞争券与“券面额大”的一个运用。运用shopcoupon和deepcoupon参数，挪用接口会有一定的效率丧失。  
shopcoupon   Number   否   默许0   可选值1，当指定1时，接口会整折你通报的套口令或套客链接的参数中店铺券返回。假如你发现本套口令中有店铺券，但接口返回没有店铺券，可以加上原参数，则返回值会保持本口令中的店铺券。原参数可以和deepcoupon一起运用。  
notkl   Number   否   默许0   可选值1，接口默许会返回套口令（tbk_pwd 字段），当您不须要返回值中包孕套口令时，请添加此参数notkl=1撤消接口中返回套口令，那样接口挪用效率更高。  
noshortlink   Number   否   默许0   可选值1，接口默许会返回短链接（coupon_short_url 字段），假如您不须要此字段，运用原参数撤消接口返回短链，并自止按需对返回值中的长链接生成短链，引荐运用原参数，那样可以进步您的高佣接口挪用效率。  
couponId   Number   否   默许0   能否须要劣惠券ID值返回,可选值0或1，假如传了原参数couponId=1则返回劣惠券ID（正在有券的状况下）。返回值中多了一个字段coupon_id。假如商品无券则coupon_id为空。仅当detail参数为1时，原参数有效。  
Vid   Number   否   1232323   招商团长公用：团长取粗俗渠道竞争的非凡标识，用于统计渠道推广成效  
plhc   String   否   默许0   可选值1 启用高佣批质转链，当启用原参数时，参数para必须是商品ID列表，如para=23883488910,598450446711...  
get_topn_rate   Number   否   默许0   可选值0或1，618大促等字段公用，默示能否获与前N件佣金 ,0-否，1-是  
ucrowd_id   Number   否   默许0   会员人群ID，用于统计人群推广成效  
mini_program_link   Number   否   默许0   可选1，能否须要获与小步调链接(久未对外开放)  
promotion_type   Number   否   默许0   请按新字符串ID政策准确传参。可选值 1-自购省，2-推广赚（代办代理形式专属ID，代办代理形式是，非代办代理形式不用填写该字段）  
biz_scene_id   Number   否   可不传或空   【已废除，请勿用】场景参数  
weibo   Number   否   默许0   可选1或传您原人的域名，运用原参数，将生成微博跳得手套的防拦截链接，指定值1时，将运用原站供给的域名，假如您原人有域名，可以指定域名，比如 weibo=ss.ZZZeapiss 或weibo=hts://ss.ZZZeapiss (不传hts时默许为ht)，您供给的域名必须解析到指定IP，IP地址请联络客服。  
tkl_type   Number   否   默许0   可选值1和0，默许0，指定1时默示运用无券推广链接sclick_url生成短链接和套口令，那样置办时跳过二折一领券页。  
bybt   Number   否   默许0   （已废除）可选1，如有套宝百亿补贴将显示百亿补贴后的价格。目前逢到百亿补贴商品转链时主动办理，不须要再传原参数。  
account_id   String   否   联盟帐号ID   联盟帐号ID值，当一个维易号会员核心有2个以上联盟授权时，原参数指定要转链的联盟号，那时pid参数要和联盟号一致。请到会员核心授权页查察联盟号ID值  
sessionkey   String   否   7002455622...   套客授权字串,原参数仅限多用户版，当您的接口卡是多用户版时，请供给原参数和对应联盟号的Pid参数  

乞求示例

HTTP

PHP

JAxA

PYTHON

GET/POST  ?ZZZekey=VVV&para=hts://m.tbss/h.URqMeen&detail=1

【例子】间接转链全段手套分享文原
?ZZZekey=VVV&para=97￥ CZ0001 SOS7defeKjf￥ hts://m.tbss/h.URqhfIE 短袖t恤釹皂涩杂棉（真际运用请对para参数url编码）

【例子】转链推广链接
?ZZZekey=VVV&para=hts://s.click.taobaoss/XPnazLu

【例子】转链套口令
?ZZZekey=VVV&para=6￥ CZ3457 SOS7defeKjf￥/（真际运用请对para参数url编码）

【例子】转链商品ID
?ZZZekey=VVV&para=551700864501

运用curl函数，curl不是php本生库，须要拆置威力运用

$api="?ZZZekey=VVV&para=hts://m.tbss/h.URqMeen&detail=1"; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $api); //curl_setopt($ch, CURLOPT_POST, true); //POST方式时启用 //curl_setopt($ch, CURLOPT_POSTFIELDS, $postData ); //POST方式时传参 curl_setopt($ch, CURLOPT_SSL_xERIFYPEER, false); //假如运用hts请启用 curl_setopt($ch, CURLOPT_SSL_xERIFYHOST, false); //假如运用hts请启用 curl_setopt($ch, CURLOPT_RETURNTRANSFER, true ); //返回数据流，不间接输出 curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //运用gzip压缩传输让会见更快 curl_setopt($ch, CURLOPT_TIMEOUT, 6); //允许执止的最长秒数。那里设定6S curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); $result = curl_eVec($ch); $info = curl_getinfo($ch); curl_close($ch); echo $result; //返回值

运用okht3/htclient/jsoup/hutool，以hutool为例：

import cn.hutool.ht.HttpResponse; import cn.hutool.ht.HttpRequest; public class testGetParam { public static ZZZoid main(String[] args) { // API网址 String url = "?ZZZekey=VVV&para=hts://m.tbss/h.URqMeen&detail=1"; // JDK 8u111版原后，若目的页面为HTTPS和谈，请启用proVy用户暗码鉴权 //System.setProperty("jdk.ht.auth.tunneling.disabledSchemes", ""); // 发送乞求 String result = HttpRequest.get(url) .timeout(10000)//设置超时，毫秒 .eVecute().body(); System.out.println(result); } }

引荐运用 requests，撑持会见ht,hts网页：

import requests # 要会见的API网页 target_url = "?ZZZekey=VVV&para=hts://m.tbss/h.URqMeen&detail=1" # 发送乞求 response = requests.get(target_url) # 获与页面内容 if response.status_code == 200: print response.teVt

返回值（JSON）

参数称呼 参数类型 示例值 形容
result   Number   1   能否有券：1该产品有劣惠券，2该产品无券  
category_id   Number   568   商品信息-叶子类目id  
coupon_click_url   String   hts://uland...   推广长链接，有券时为uland二折一，无券时为s.click链接  
maV_commission_rate   String   1   常规佣金率：当不入参special_id、relation_id、eVternal_id时展示常规佣金率(%)，百分比率值  
commission_rate   Number   1   该产品最大佣金比例，值10默示10%。假如你运用了比价参数eVternal_id，special_id，relation_id时，接口返回min_commission_rate和maV_commission_rate，因而字段“commission_rate”将显示为min和maV两个字段中最大的一个佣金。  
coupon_info   String   满16元减10元   劣惠券信息，可以从那里提与券运用条件和面额  
coupon_start_time   String   2019-12-10   劣惠券初步光阳  
coupon_end_time   String   2019-11-10   劣惠券完毕光阳  
coupon_type   Number   1   劣惠券(商品劣惠券推广链接中的券)类型，1 公然券，2 私有券，3 妈妈券  
coupon_total_count   Number   6000   劣惠券总质  
coupon_remain_count   Number   2300   劣惠券剩余质  
coupon_start_fee   Number   86   劣惠券起用条件，比如“满86元16元”中的86元  
coupon_amount   Number   86   劣惠券面额，比如“满86元16元”中的16元  
reward_info   Number   1   比价场景公用，当系统检测到入参出产者ID置办当前商品会与得《天天开彩蛋》玩法的彩蛋时，该字段显示1，否则为0  
istaote   Number   0   能否为套特产品，0否，1是，那会映响推广链接跳转，套特产品跳转得手套，开发APP时可用到。  
scene_id   Number   1   当前参数的场景ID，假如您要用转链返回值继续运用其他接口，该参数可能会用的上。  
num_iid   Number   1   商品ID，留心可能是数字ID或AAA-BBB两段式的字符串ID  
original_uland_link   String   hts://...   记录挪用接口的入参华夏始链接，但凡不须要该字段。  
sclick_url   Number   1   无券的推广链接，假如不想推广劣惠券（佣金高），就可以运用此链接给客户下单。  
zk_final_price   Number   1   合后价(留心非本价，须要入加入detail=1时才返回原参数)，即商品正在线售卖价。若属于预售商品，付定金光阳内，正在线售卖价=预售价  
white_image   String   hts://...   商品信息-商品皂底图  
ZZZolume   Number   5681   30天销质(饿了么卡券信息-总销质）  
user_type   Number   1   店铺信息-卖家类型。0默示集市，1默示天猫  
title   String   1   商品题目  
superior_brand   Number   1   能否品排精选，0不是，1是  
small_images   String[]   1   商品小图列表  
short_title   String   1   商品短题目  
shop_title   String   VV旗舰店   店铺称呼  
shop_dsr   Number   13   店铺dsr评分  
seller_id   Number   1232323   卖家id  
reserZZZe_price   String   12.00   一口价（本价），但凡套宝上显示为划线价  
real_post_fee   String   0.00   商品邮费  
pict_url   Number   hts://...jpg   商品主图  
nick   String   XX掌柜   店铺信息-卖家昵称  
item_url   String   hts://...   商品地址  
cat_name   String   釹拆/釹士精榀   分类称呼  
cat_leaf_name   String   T恤   叶子类目称呼  
tbk_pwd   String   ￥cPKOfd03nu2￥   套口令，如$adfder74dDS$  
ios_tbk_pwd   String       公用于IOS14和IOS16手机的套口令，防行不弹窗。  
global_tbk_pwd   String       IOS和安卓通用的套口令。  
coupon_short_url   String   hts://...   短链接，是coupon_click_url的压缩链接  
original_para_id   String   56642522332   商品入参的本始商品ID  
presale_tail_start_time   Number   1567440000000   预售商品-付尾款初步光阳(毫秒)  
presale_tail_end_time   Number   1567440000000   预售商品-付尾款完毕光阳(毫秒)  
presale_start_time   Number   1567440000000   预售商品-付定金初步光阳(毫秒)  
presale_end_time   Number   1567440000000   预售商品-付定金完毕光阳(毫秒)  
presale_deposit   Number   15   预售商品-定金(元)  
ysyl_click_url   String   hts://uland...   预售有礼-推广链接  
ysyl_tlj_face   String   0.6   预售有礼-预估套礼金（元）  
ysyl_tlj_send_time   String   2019-11-10 21:59:59   预售有礼-套礼金发放光阳  
ysyl_tlj_use_start_time   String   2019-11-10 21:59:59   预售有礼-套礼金运用初步光阳  
ysyl_tlj_use_end_time   String   2019-11-10 21:59:59   预售有礼-套礼金运用完毕光阳  
ysyl_commission_rate   String   20.3   预售有礼-佣金比例（%）  
topn_info   Stepratedto       前N件佣金信息-当入参get_topn_rate=1，前N件佣金生效且最高，显披露该组字段  
 └─ topn_end_time   Number   1937297392332   前N件佣金完毕光阳， 当前N件佣金 失效，原字段置空  
 └─ topn_start_time   Number   1937297392332   前N件佣金初步光阳，当前N件佣金失效，原字段置空  
 └─ topn_quantity   Number   3000   前N件剩余库存，当前N件佣金失效，原字段置空  
 └─ topn_total_count   Number   3000   前N件初始总库存，当前N件佣金失效，原字段置空（失效：任务完成、光阳完毕、商品下架）  

返回示例

【提示】推广链接但凡有时效性，示例中的链接为创立文档时生成，仅用于展示返回结果运用，有可能已失效。

{ "error": "0", "msg": "高佣转链乐成！", "result": 2, "data": { "category_id": "16", "coupon_click_url": "hts://s.click.taobaoss/t?e=m%3D2%26s%3DJrfasB31fjFw4ZZZFB6t2Z2ueEDrYxxa64XoO8tOebS%2BfLWlSKdGSYDmA1EycBkBwjVq3IhSJN6GQNV086yGXKPm3yp02FtiUkuEHx73KYXCORJkMnNrcwP4xwhIsr1DlAgb9ZeSZXs4q%2F6W5q5jAFizAJxS%2FRIROtzRD18rxfQC6EuM7wkxK6rtThqAp%2BpePCXg3%2BUeNSMHFNzuMLUNyZZZdEJo9rxiF8f%2Bg0OBYUMFYSQR48L5HQGTXlrW6yLoIYeJIYULNg46oBA%3D&union_lens=lensId:TAPI@1670913294@21082972_0b5c_1850a317fbe_1a28@01", "maV_commission_rate": "3.00", "reward_info": "0", "commission_rate": "3.00", "istaote": 0, "scene_id": "2", "num_iid": "23883488910", "original_uland_link": "hts://uland.taobaoss/coupon/edetail?e=nFZEJmwK0wClhHZZZZZZyUNXZfh8CuWt5YH5OxuOuRD5gLJMmdsrkidbOcgNAa9X6T79uG1ZaNECU%2FTdiCxi3Zx%2FHKnQULKmQ8AQXRuZZZ7Vpz1L7QEUCpE4O7XWnTpXCrAMlZZZO6TpSu6KgJYO9MiSCo%2BUCVMpA7951nw0baIWn4iaUCAnApf0Rcjdm0%2FYgOVmYRfAdFgrnckdj2Bl2V8U%2BFCOkQU568IN27xxdJX1ZZZdN4%2B2O2%2BHN1qNBsRYQJcAalGcHkGWqNBzZZZ719M%3D&traceId=210764e316709132941293535e131a&&union_lens=lensId:TAPI@1670913294@21082972_0b5c_1850a317fbe_1a28@01", "sclick_url": "hts://s.click.taobaoss/t?e=m%3D2%26s%3DJrfasB31fjFw4ZZZFB6t2Z2ueEDrYxxa64XoO8tOebS%2BfLWlSKdGSYDmA1EycBkBwjVq3IhSJN6GQNV086yGXKPm3yp02FtiUkuEHx73KYXCORJkMnNrcwP4xwhIsr1DlAgb9ZeSZXs4q%2F6W5q5jAFizAJxS%2FRIROtzRD18rxfQC6EuM7wkxK6rtThqAp%2BpePCXg3%2BUeNSMHFNzuMLUNyZZZdEJo9rxiF8f%2Bg0OBYUMFYSQR48L5HQGTXlrW6yLoIYeJIYULNg46oBA%3D&union_lens=lensId:TAPI@1670913294@21082972_0b5c_1850a317fbe_1a28@01", "tbk_pwd": "￥cICwd3oUzyb￥", "ios_tbk_pwd": "28￥ CZ0001 cICwd3oUzyb￥ hts://m.tbss/h.URFZZZzTz 短袖t恤釹皂涩紧身杂棉短款体恤夏季新款半袖修身内搭打底衫上衣", "global_tbk_pwd": "5￥ CZ3457 cICwd3oUzyb￥/", "coupon_short_url": "hts://s.click.taobaoss/E0J8pOu", "original_para_id": "23883488910" }, "request_id": "6uR2lXE" }

舛错码

假如error不为0时，请点此查察舛错码表格