淘客联盟接口开发文档：高佣转链接口
高佣转链接口
【API通用原则】
1、本站所有接口都是基于utf-8编码，当您的网站等应用是gbk等编码，请转码后发送。
2、所有接口返回值均为JSON。没有xml等格式。
3、除订单查询接口外，其它所有接口必备参数为vekey和para ，其它参数按需传送。
4、全站接口，如无特别说明，均为 GET 请求
【重要】随淘宝联盟官方对淘口令解析接口 降低优惠数、提高收费价格，受此影响，接入本站接口如果是淘口令，请先自行使用官方淘口令解析接口，取出其中的url链接，再发给本站接口转链。该接口地址：淘口令解析
本站将逐步禁止直接传递淘口令的参数。详情：http://api.432520.com/example/
高佣金转链接口使用说明：
高佣转链包含：id转高佣淘口令、淘口令转淘口令、链接转淘口令、图片转高佣淘口令等等，站内有两种接口卡可按需选购：
1、新淘客、中小淘客、开发者：可以订购5000次的点卡，可以调用所有转链接口。
2、中型以上淘客：使用月卡，可以高频次调用。年卡便宜。
请参考本文使用接口，简单易用。可以查看
在线淘客工具网查看效果
一、接口介绍：
高佣转链接口，帮您获取淘客联盟最高佣金比例，并自动帮您申请定向计划，帮您多赚5倍。
唯易高佣接口和普通高佣金转链接口区别：
1、自带解密功能：不仅仅转链普通ID参数，还对任意二合一，s.click，或tb.cn等短链接等解密后转链。
2、自动二次处理无券产品：唯易接口对无券商品自动转高佣链接（同时返回原始二合一链接供您按需使用）。普通接口对无券产品生成的是错误的二合一链接，跳转后提示优惠券已失效，影响用户体验。
3、更强的参数处理能力：除了id转高佣链，淘口令转淘口令（包含解密功能），各种链接（二合一、产品链、短链接、天猫链等）转淘口令。一个接口搞定各种情形，大大简化你的程序。
提示：使用高佣转链前，请务必完成帐户拉新（可委托本站拉新），具备高佣金权限。否则接口无效。
二、接口地址（调用方式 GET）：
高级高佣请直接使用第1种全能转链接口（hcapi），一个接口搞定所有形式。
其它单项转链接口按需调用即可。二维码图片解析转链，需要单独调用。
以下高佣接口全部使用GET方式调用，推荐第一种hcapi，对链接转高佣会员卡则用hclink
1、【推荐】高级高佣全转链接口（id,淘口令,链接转淘口令）： hcapi
此API全能处理各种转链需求，比如id转链高佣、链接转高佣等等：
http://api.a.com/hcapi?vekey=你的vepkey¶=产品ID或二合一等各种链接（务必url编码后传参）......
高级版用户只要hcapi即可，本接口参数不必区分id或淘口令或链接，直接给para参数即可
2、【按需使用】id转高佣淘口令接口： hcid
http://api.a.com/hcid?vekey=你的vepkey¶=产品ID
本接口仅转链ID参数，通常不需要调用，高级高佣按需使用。示例（vekey示例用，请换成您自己的vekey）：
http://api.a.com/hcid?vekey=xxxxxxxxx¶=567409957366
3、链接转高佣接口： hctkl 和 hclink
【注意】因淘宝开始对基础API收费（点此查看），受此影响，淘口令转淘口令（hctkl）接口下个月将逐步禁用，
请先 自己提取淘口令中的链接 再发给本站接口（hclink或hcapi）解密和转链。
（a）链接转淘口令： http://api.a.com/hclink?vekey=你的vepkey¶=https%3A%2F%2Fuland.taobao.com%...
（b）淘口令转淘口令（逐步禁用直接传递淘口令，请先提取淘口令中的链接再发给 hclink 接口）：
http://api.a.com/hctkl?vekey=你的vepkey¶=￥D9l10C3rdQz￥
注意：链接要编码后传入参数para。
比如上例是 https://uland.taobao.com/coupon/edetail?e=M4Nc... 编码后是https%3A%2F%2Fuland.taoba.....
4、图片转高佣淘口令： hcimg
本接口是高级接口，用于把带有二维码图片，主要场景：最新淘宝或天猫生成的图用于防微信封锁；或一些客户会把别家的带二维码产品图片发给你的公众号或APP，希望能查券。这些都需要把图片中二维码解析成为您自己的淘口令。以后这类场合会越来越多。
http://api.a.com/hcimg?vekey=你的vepkey¶=图片参数（参说明）
参数 para 必知：
它有两种情形，对应不同的请求方式：
（1）网络图片：如 http://api.a.com/a.jpg，比如你的微信机器人接收到的图片，直接把图片地址做为para参数调用接口。此时用get请求。
（2）图片内容：有两种情形：一是base64内容，二是buffer数据，比如php的file_get_contents()函数读取图片的内容。这两种大容量的参数，请务必用post方式传送para参数。
示例：GET请求解码图片。
http://api.a.com/hcimg?vekey=你的vepkey¶=http://api.a.com/a.jpg
【接口请求方式】GET方式 （仅图片转高佣中提交图片base64或二进制数据时使用post）
高佣转链接口测试 >>
三、接口参数说明：
（一）公共参数：vekey和para
1、参数vekey：是所有接口必备的，用于验证您调用此接口的权限。
2、参数para：基本所有都有此接口，用于传递所需参数，它的类型和接口相关。
（1）在id转淘口令接口中，para要传递产品id
（2）在淘口令转淘口令接口中，para要传递别人的淘口令，接口将它转为您的淘口令。
（3）在链接转淘口令接口中，para要传递二合一链接或s.click链接。
（4）图片转淘口令接口中，para是网络图片地址，或用POST请求方式发送图片base64或二进制数据
（二）其它非必需参数：
完整URL接口地址：
http://api.a.com/hcid?vekey=你的vepkey¶=主参数&pid=mm_11_22_33&sina=1&detail=1&sessionkey=71005..
1、pid：值为mm_xxx_xxx_xxx。当你在会员中心设置了默认Pid后，如果不需要更换PID，就不需要传递本参数。接口默认会调用你设置的pid，当您需要换为同一淘客帐号下的其它pid，那么就传递pid参数。
当时，如果是多用户版的用户，您在本站授权和设置Pid的淘客号是默认的主号，而主号以外的、您的代理或子帐号调用接口时，就必须传递pid参数以及下面的sessionkey参数。
2、sina ：值为1。表示是否要把转链生成的短链接生成新浪t.cn短网址，默认是淘宝的短网址，比如：
https://s.click.taobao.com/lWz8kQw
如果传递 &sina=1 则会生成：
http://t.cn/RBFwwuT
短网址主要是用于QQ群推送或微信推送时使用。如无必要不必传送sina参数。
3、detail ： 值为1. 是否返回具体产品介绍，如果您需要高佣转链接口要返回更详细的产品信息，不需要再去调用其它接口，可以传递detail参数。结果比较参下文“返回值”。
4、sessionkey ： 值为淘客授权字串。本参数仅限多用户版，当您的接口卡是多用户版时，如果非默认的帐号调用，比如您的代理公众号调用，则需要传递他的淘客号授权sessionkey 以及该帐号下的pid
四、返回值：
返回值格式： json
分简略版和详情版。
【注意】
1、以下两种返回值都带有已经转化成你的PID的 coupon_click_url 推广链接和 tbk_pwd 和 coupon_short_url 三个值。您可以直接分发给客户使用。
2、返回值中，当产品没有优惠券时，比有优惠券的会少了几个字段，因此你的程序要做判断避免出错：
比如在PHP中，要做 if(!empty($re['coupon_info'])){ ...... } 的判断，此字段不存在或为空时，表示该产品没有优惠券。
以下是返回值：
1、当没有detail参数时：如图
（1）有优惠券：
（2）无优惠券：
其中original_uland_link是原始的高佣二合一链接，跳转到领券页后，会提示优惠券领完，可以使用 coupon_click_url，这两个字段看自己需要。
（3）产品下架或者非淘客联盟产品时返回：
2、当带上detail参数时：如图
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：该产品佣金，多级代理依此值计算
num_iid：产品ID
tbk_pwd：淘口令，此口令是已转化成你自己PID的口令，可直接使用
coupon_short_url：短链接，如有QQ推广等场景，已转化成你自己PID的口令，可直接使用。
original_uland_link ： 无券产品的原始二合一链接。（无券时才有此字段，不推荐使用，仅做为原始数据返回，直接使用会提示优惠券失效）
【其它详情版参数】
title：产品标题
zk_final_price：产品折后价
reserve_price：原价
volume：最近30天销量
cat_name：分类名
cat_leaf_name：分类子叶
seller_id：卖家id
user_type：1、表示天猫，0、表示淘宝
item_url：表示产品链接地址（天猫国际有的也是taobao.com链接，要结合user_type分析）
五、错误时返回值：
当找不到产品，或出错时，返回值json如：
{"error":"请传递产品ID、或淘口令，或淘客链接"}