维易淘客联盟接口开发文档:高佣转链接口

高佣转链接口-万能高佣API转链-微博防屏蔽

【API通用原则】

1、本站所有接口都是基于utf-8编码,当您的网站等应用是gbk等编码,请转码后发送。

2、所有接口返回值均为JSON。没有xml等格式。

3、全站接口,如无特别说明,均为 GET 请求


一、接口介绍:

维易万能转链接口,两千多客户不断反馈,近2年多时间的沉淀!

全面处理各种奇形古怪的参数,简单暴力好用的接口,简化你的程序,提高你的成交机会!

高佣转链接口,帮您获取淘客联盟最高佣金比例,并自动帮您申请定向计划,帮您多赚更多。

唯易高佣接口和普通高佣金转链接口区别:

1、全面的参数处理能力:近2年的沉淀,可以处理几乎所有的场景参数,除了id转高佣链,淘口令转淘口令(含解密功能),各种链接(二合一、产品链、短链接、天猫链等)转淘口令。一个接口搞定各种情形,大大简化你的程序。

2、自动二次处理无券产品:对无券商品自动转高佣链接。普通接口对无券产品生成的是错误的二合一链接,跳转后提示优惠券已失效,影响用户体验。

3、兼容商家合作券:有的商品联盟中并没有优惠券,接口可以兼容该商品其它优惠券,比如商家合作券。

4、支持生成微博防拦截的淘客链接功能。使用该功能,可生成防止微博挡截的链接,把它发到微博上,不会被微博屏蔽,也不需要再交纳50%佣金给微博。


高佣金转链接口使用注意事项:

高佣转链接口包含:id转高佣淘口令、淘口令转淘口令、各种链接转淘口令......等几乎所有应用场景。

但是使用高佣转链前,请务必完成帐户升级(可委托本站帮忙升级),为什么?

1、如果您的联盟帐号是初级的,那么联盟的所有商品只给您一种佣金可选,因此用高佣接口没有意义。

2、如果你的联盟帐号升高级后,联盟会把商品所有可选的1-4种佣金开放给你选择,这时使用本站高佣转链API,就可以从这几种佣金中取最高一个。这时高佣转链API才有意义。



二、接口地址(调用方式 GET):

高级高佣请直接使用第1种全能转链接口(hcapi),一个接口搞定所有形式。

以下高佣接口全部使用GET方式调用:


【特别通知】

请近日调用接口,如果有需要生成淘口令,请增加参数appkey和secret,避免不弹窗影响,

参考:http://wsd.591hufu.com/taokelianmeng/443.html


1、【万能转链】高级高佣转链接口(id,淘口令,链接转淘口令): hcapi

此API全能处理各种转链需求,比如id转链高佣、链接转高佣等等。

使用权限:全能卡、超级卡、高级版使用

http://api.vephp.com/hcapi?vekey=xxx&para=产品ID或淘口令链接等各种参数(urlencode编码)...&pid=其它可选参数,参后面第3节

以上参数是主参数,更多参数请参考下节。

本接口参数 para 可传参数类型(请做urlencode编码后传参)


(1)淘宝产品id:比如 557662422568 或直接产品链接 //item.taobao.com/item.htm?id=...

(2)二合一链接:比如 https://uland.taobao.com/coupon/edetail?e=...

(3)s.click.taobao.com 长和短链接,比如 https://s.click.taobao.com/M9CMYLw 

(4)天猫的喵口令 如 http://zmnxbc.com/s/YJk6Z

(5)手淘APP的分享链接:http://m.tb.cn/h.WDXp8bv

(6)别人的淘口令:如 ¥40pM0yyztET¥,或手淘分享链接文本直接传参数。

(7)新浪短网址,百度短网址封装的淘宝链接:http://t.cn/E6jP2DJ

(8)其它一些不常见的淘客链接

(9)手淘上分享的内容直接做参数传参数。 如:

【langtian浪天电动牙刷成人款家用非充电式声波自动牙刷软毛防水】http://m.tb.cn/h.WyeyGDw 点击链接,再选择浏览器打开;或复制这条信息¥7TT90t9FVqQ¥后打开手淘

这段文字直接urlencode后传给para参数即可。


hcapi接口不区分以上参数类型,直接传参给para参数即可,接口自动识别


  说明

(1)全能卡、超级卡、高级版等会员只用 hcapi 即可(包含以下接口所有功能)。不需要使用以下接口。

(2)以下 hcid, hclink, hctkl 主要由辅助接口会员使用。


2、【辅助接口】id转高佣淘口令接口 hcid

http://api.vephp.com/hcid?vekey=你的vepkey&para=产品ID

本接口仅转链ID参数,高级高佣的hcapi已自带本功能。示例(vekey示例用,请换成您自己的vekey):

http://api.vephp.com/hcid?vekey=xxxxxxxxx&para=567409957366


3、辅助接口链接转高佣接口: hctkl 和 hclink

hclink接口不包含id转链,因此链接参数不接收淘宝或天猫的产品链接,这类链接使用id转链需要高级版。


         (a)链接转淘口令: http://api.vephp.com/hclink?vekey=你的vepkey&para=https%3A%2F%2Fuland.taobao.com%...

                                         【注意】hclink链接参数不包含淘宝或天猫的产品链接。

         (b)淘口令转淘口令: 

              http://api.vephp.com/hctkl?vekey=你的vepkey&para=¥D9l10C3rdQz¥


注意:链接要编码后传入参数para。

比如上例是 https://uland.taobao.com/coupon/edetail?e=M4Nc... 编码后是https%3A%2F%2Fuland.taoba.....


【接口请求方式】GET方式 


三、接口参数说明:

(一)公共参数:vekey和para 

1、参数vekey:是所有接口必备的,用于验证您调用此接口的权限。

2、参数para:基本包含了所有淘客场景,参前文8种para参数,在辅助接口中,则有对应参数规格要求:。

     (1)在id转淘口令接口中,para要传递产品id

     (2)在淘口令转淘口令接口中,para要传递别人的淘口令,接口将它转为您的淘口令。

     (3)在链接转淘口令接口中,para要传递二合一链接或s.click链接。


(二)其它非必需参数:

完整URL接口地址:

http://api.vephp.com/hcapi?vekey=你的vepkey&para=主参数&pid=mm_11_22_33&detail=1&sessionkey=.....&activityId=bdsaf..


1、pid:可选,值为mm_xxx_xxx_xxx。当你在会员中心设置了默认Pid后,如果不需要更换PID,就不需要传递本参数,此时接口默认会调用你设置的pid。当您需要换为同一淘客帐号下的其它pid,那么就传递pid参数。

但是,如果是多用户版的用户,您在本站授权和设置Pid的淘客号是主号,而主号以外的、您的代理或子帐号调用接口时,就必须传递pid参数以及下文的sessionkey参数。

【很重要】

(1)当您使用的是渠道ID时,请务必使用“渠道专属PID”。

(2)当您使用的是会员运营ID绑定订单,请勿必使用“会员专属PID”。


2、relationId (注意大小):可选,渠道关系ID值,适用于渠道推广场景。普通转链不需要本参数

【注意】使用渠道ID,务必满足2个要点:

1、使用专属渠道PID或会员专属PID。

2、传递relationId参数指定渠道rid。

满足以上两个条件后,转链下单,可用订单接口指定order_scene=2来查询渠道订单。

更多渠道用法参考 http://wsd.591hufu.com/doc/taokequdaojiekou 


3、sessionkey : 淘客授权字串。本参数仅限多用户版,当您的接口卡是多用户版时,如果非默认的帐号调用,比如您的代理公众号调用,则需要传递他的淘客号授权sessionkey 以及该帐号下的pid


4、detail : 可选,0默认值)或1,0或不设置表示不显示产品具体信息。若指定值为1显示产品信息。如果您需要高佣转链接口要返回更详细的产品信息,不需要再去调用其它接口,可以传递detail参数。结果比较参下文“返回值”。


5、activityId:可选值0或自己指定优惠券id,提供本参数后,接口自动在返回的推广链接后面添加该券id,并获取该优惠券信息字段一起返回。本参数和 deepcoupon参数只能使用一个,如果一起使用,则deepcoupon参数失效。


6、deepcoupon:可选值0或1或2:默认值0,当指定1或2时,则接口会对商品进一步检查商家合作优惠券,参数值含义:1-表示对联盟产品无官方优惠券时,则进行检查是否有商家合作券;2-(不建议)表示不管转链的商品有没有券,都进行进一步检查商家合作券,如果商品本身就有单品券,则与检查出来的商家合作券取“券面额大”的一个使用。

本参数和activityId参数二选一,如果一起使用,则以activityId优先,本参数失效。

【tip】优惠券小知识:三种优惠券:

(1)官方单品券(妈妈券):转链接口默认就是直接获取联盟商品官方单品券,这类券是商家在联盟后台直接设置的。

(2)商家合作券:这类券是商家和接口平台合作的券,当你添加deepcoupon=1或2时,将会检查这类券。

(3)店铺券:即商家店铺优惠券,全店商品适用,所以当然也可以用于这个商品。


【以下两个7和8参数,会提高您的程序效率】


7、notkl :可选值【重要】,值为1:接口默认会返回淘口令(tbk_pwd 字段),当您不需要返回值中包含淘口令时,请添加此参数notkl=1取消接口中返回淘口令,这样接口调用效率更高。


8、noshortlink :可选值【重要】,值为1:接口默认会返回短链接(coupon_short_url 字段),如果您不需要此字段,或自己有淘宝客基础API权限和SDK包,使用本参数取消接口返回短链,并自行按需对返回值中的长链接生成短链,强烈推荐使用本参数,这样可以提高您的高佣接口调用效率。


【以下9和10参数,生成不同使用场景的短链】


9、sclickurl 可选,值固定为1,或不传,当产品有优惠券时,但有时你可能只需要s.click链接,也就是有统计淘客推广佣金,但不需要领取优惠券,那加本参数,可以获取s.click链接。


10、shorturl :可选,值为0(或不设置)或1。表示是否要把转链生成的短链接生成短网址,默认0或不设置,则使用淘宝短网址,比如:

https://s.click.taobao.com/lWz8kQw

如果传递 &shorturl=1 则会生成新浪t.cn或uee短网址(视可用情形):

http://t.cn/RBFwwuT 或 http://uee.me/ck2GC

短网址主要是用于QQ群推送或微信推送时使用。如无必要不必传送shorturl参数。

【注意】本参数生成的短链主要用于网络软文或论坛贴子推广,不适合于微信上推广(微信主要靠防封图,否则因众所周知的腾讯和阿里两家互相屏蔽的原因,短链直接解析出的淘宝推广链接,在微信或QQ上也是无法打开的)。

如果您需要在微博推广,则需要下面的weibo参数。


11、weibo : 可选,值固定1,或不传。如果需要在微博推广,在微博中贴文中包含淘客推广网址,则添加本参数,可以生成防止新浪微博屏蔽的短网址,并直接跳到淘宝APP领券。使用本参数后,在返回值字段coupon_short_url中获取到防微博拦截的短链。

【注意】使用必知

(1)短网址在手机上直接跳到淘宝APP领券页。

(2)使用本参数获取的链接仅适合微博推广,不适合微信和QQ等腾讯应用。

(3)参数weibo和shorturl只能同时使用一个:当两个参数一起使用时,则shorturl参数失效。

(4)如果你需要在其它网站推广,以便百度收录和软文推广中包含短链,则建议用shorturl参数。

(5)如果需要手动生成微博防封短链,请使用在线工具http://wsd.591hufu.com/weibo.php


12、me :营销计划链接中的me参数,一般不使用。


13、tklpic : 淘口令主图:在接口没有指定notkl 参数时,默认是有返回淘口令,淘口令主图默认是使用产品淘宝天猫主图第一张,如果你设置了tklpic参数,提供了自定的网络主图,则生成淘口令将使用您提供的图片地址做封面。


14、appkey secret 备用参数: 这2个参数,是提供你自己的应用密钥(淘宝开放平台——应用管理)生成淘口令,可以避免在某些时侯受外部影响。如果你提供了notkl参数,则不需要这2个参数。

【使用场景】在双11等高负载场合,联盟有可能出问题,比如淘口令不弹窗,那么请加上appkey和secret这2个参数,避免生成的淘口令受别人影响。就可以解决淘口令不弹窗问题。

如何申请淘口令权限,参考http://wsd.591hufu.com/taokelianmeng/443.html


四、返回值:

返回值格式: json

分简略版和详情版。


【如何计算佣金】

佣金是根据“券后价*佣金比例”预估的,券后价分3步计算(请先熟悉下文返回值):

1、提取优惠券面额:从优惠券字段 coupon_info 中提取券面额(参考下文返回值),格式都是固定的“满XX元减yy元”,提取YY元就是券面额。

2、计算券后价:用折后价字段 zk_final_price(这个就是商品在淘宝天猫售价,注意不是原价)减去 券面额YY元,“zk_final_price - yy”元就是券后价。

3、计算预估佣金:“券后价 * 佣金比例字段commission_rate”,注意commission_rate是百分比,不是小数,因此该值20表示20%,还需要转成小数。

最后要注意的是,这个是买前预估理想佣金值,实际下单,还要扣除税收、以后可能使用红包导致变低佣等影响,具体参考订单接口。

有关丢单,参考http://wsd.591hufu.com/taokelianmeng/114.html 


【注意】

1、以下两种返回值都带有已经转化成你的PID coupon_click_url 推广链接和 tbk_pwd 和 coupon_short_url 三个值。您可以直接分发给客户使用。

2、返回值中,当产品没有优惠券时,比有优惠券的会少了几个字段,因此你的程序要做判断避免出错,也可以使用result来判断是否有优惠券:


比如在PHP中,要做  if(!empty($re['coupon_info'])){ ...... } 的判断,此字段不存在或为空时,表示该产品没有优惠券。

如果用 result 判断是否有优惠券:1-该产品有优惠券,2-表示该产品无优惠券。


以下是返回值:

【注】优惠券面额从coupon_info中提取,格式都是固定“满XX元减YY元”,提取出YY元即为优惠券面额。


1、当没有detail参数时:如图

(1)有优惠券:


2018年8月20号左右,接口推出最新妈妈券返回值字段,如下面“mm_开头”的字段 :

详情参 http://wsd.591hufu.com/taokelianmeng/282.html 



(2)无优惠券:

其中original_uland_link是原始的高佣二合一链接,跳转到领券页后,会提示优惠券领完,

建议使用 coupon_click_url,不会到领券页,而是直接跳到产品页,体验感较好。

这两个字段看自己需要选择。


(3)产品下架或者非淘客联盟产品时返回:



2、当带上detail参数时:如图



【注】优惠券面额从coupon_info中提取,格式都是固定“满XX元减YY元”,提取出YY元即为优惠券面额。


result 表示是否有优惠券:1-该产品有优惠券,2-表示该产品无优惠券

category_id :分类ID

coupon_click_url :已转链后的您的二合一链接(有券产品)或s.click链接(无券产品),可直接使

coupon_end_time:优惠券过期时间 (有优惠券时才有此字段)

coupon_info:优惠券信息,格式都是“满xx元减xx元”(有优惠券时才有此字段)

coupon_remain_count:剩余优惠券数量,当为0时优惠券失效。(有优惠券时才有此字段)

coupon_start_time:优惠券开始时间(有优惠券时才有此字段)

coupon_total_count:优惠券发放总量 (有优惠券时才有此字段)

coupon_type:优惠券类型:1 公开券,2 私有券,3 妈妈券 (有优惠券时才有此字段)

commission_rate:该产品佣金比例,多级代理依此值计算。值10表示10%。

num_iid:产品ID

tbk_pwd:淘口令,此口令是已转化成你自己PID的口令,可直接使用

coupon_short_url:短链接,如有QQ推广等场景,已转化成你自己PID的口令,可直接使用。

original_uland_link : 无券产品的原始二合一链接。(无券时才有此字段,不推荐使用,仅做为原始数据返回,直接使用会提示优惠券失效)


【双11参数——仅双11大促时有】

1、双11期间,增加detail参数时,获取到以下字段:

presale_discount_fee_text: 预售商品-商品优惠信息,如“付定金立减20元”

presale_tail_end_time: 预售商品-付定金结束时间(毫秒)

presale_tail_start_time:预售商品-付尾款开始时间(毫秒)

presale_end_time:预售商品-付定金结束时间(毫秒)

presale_start_time:预售商品-付定金开始时间(毫秒)

presale_deposit: 预售商品-定金(元)

2、双11期间,高佣转链接口返回“ysyl_”开头的字段,是预售有礼字段,

参考https://tbk.bbs.taobao.com/detail.html?postId=9336539

ysyl_click_url  预售有礼-推广链接

ysyl_tlj_face  预售有礼-预估淘礼金(元)

ysyl_tlj_send_time  预售有礼-淘礼金发放时间

ysyl_tlj_use_end_time  淘礼金使用结束时间

ysyl_tlj_use_start_time  淘礼金使用开始时间

ysyl_commission_rate  预售有礼-佣金比例(%)


【其它详情版参数】

title:产品标题

zk_final_price:产品折后价

reserve_price:原价

volume:最近30天销量

cat_name:分类名

cat_leaf_name:分类子叶

seller_id:卖家id

user_type:1、表示天猫,0、表示淘宝

material_lib_type : 商品库类型,支持多库类型输出,以“,”区分,1: 表示为营销商品主推库

item_url:表示产品链接地址(天猫国际有的也是taobao.com链接,要结合user_type分析)


五、错误时返回值:

当找不到产品,或出错时,返回值json如:

{
    "error": "6001",
    "msg": "请传递产品ID、或淘口令,或淘客链接"
}

具体错误码参考 http://wsd.591hufu.com/doc/taobaokeapijiekoucuowuma

 

客服

关注