当前位置:淘客联盟接口开发文档(旧版) > 二维码发单图
接口文档

微信中间页防封锁二维码发单图(多套模板)

迁移提示这是 旧版 文档, 最新文档请点击这里查看

使用接口生成淘宝客二维码推广发单图,主要是在微信上使用。有两个功能:

1、生成普通产品在微信上推送的发单二维码图,扫码后到中间页复制淘口令跳到领券页或淘宝详情页。

2、生成聚划算拼团的发单二维码图。扫码后到中间页复制淘口令跳到指定活动页面地址。


两个二维码发单图都是在微信等场景让人扫码后,进入我们提供的中间页扫码,复制淘口令后打开手机淘宝,就可以跳转到相应网址购买。

注意返回值中取得的图片地址要及时保存到您的本地服务器,本站每3天清理一次服务器。


本接口提供域名用于二维码发单图跳转,也可以您自行指定域名。生成的二维码图,主要用在微信上,可以很好的防止微信封锁域名和您的微信号。


以下介绍两种功能分别调用方式和参数:


一、淘客普通产品微信二维码发单图生成接口:

此接品用于在线生成淘宝客在微信上推送的二维码图。可以传给接口各种各样的内容,直接生成包含你的高佣的跳转网址,客户直接在网址上复制口令,相信一般有接触过淘客的人都知道用处,不多介绍。

效果:这类二维码图扫码后,会跳到中间页,复制产品高佣淘口令,打开手机淘宝就可以跳转到产品领券页。

注意:本接口自带高佣API转链功能,不需要先转链后再发给本接口生成图片。


二维码发单图简介【3套模板】

先看一下二维码效果图:

关于图片:目前提供3套二维码图模板,如果您认为有更好看的模板,可以提供给我们免费定制

模板1:默认二维码图(洗面奶有优惠券,学习机无优惠券):


     


模板2:左边无优惠券,右边有优惠券:

    

模板3:带自己logo的二维码图:

如下例,带有花生日记logo


上方是3套二维码图模板,有一些构图要素说明如下(以模板1为例):

1、有优惠券的产品:

注意上面的一些要素,下面参数会涉及:

(1)优惠券红色背景图(模板2无此要素)由下面参数showcp控制是否显示。如果产品本身没有优惠券,则自动不显示此优惠券模块。

(2)附加文字:由参数addtxt决定,传递附加文字。比如模板2中“可领返现5元”。


2、无优惠券产品(模板2无此要素):


下方有提示“(无优惠券)”,这个可以不显示,传递参数nocptxt=0即可取消。



【生成微信二维码发单图接口】

http://api.veapi.cn/tbk/qrpic?vekey=xxx&para=主参数&tpl=1&pid=mm_...你的PID(可选)

说明:

1、此接口自带高佣API功能,所有在hcapi高佣转链接口上的参数,在这里都可用,也不需要先高佣接口转链再发淘口令给本接口。比如上面的pid,若是多用户版,可以传递你的下级代理或客户的授权 sessionkey值以及他的淘客pid参数。

2、请及时保存到您自己的服务器,网站每3天清理一次,因此,您取得图片地址后,还需要自己保存到本地服务器。


【接口参数】

接口的主要参数是para即可获得图,以下是接口参数说明:

【特别说明】本接口可以传递万能转链接口hcapi参数,比如relationId参数。


1、para参数:接受以下类型的参数生成产品发单图:

    (1)淘口令:比如客户在您的公众号或机器人上发了一个淘口令,这个口令可能是别人的,或手淘的,或天猫APP的。只要发给本接口,直接生成您的二维码图。

    (2)各种链接:包括二合一加密链接、tb.cn和zmnxbc.com短链接、s.click短链接等等,可以参考这里介绍

    (3)产品ID:这是最基础功能。

    (4)无券产品链接:也是以s.click开头的长链接。


2、pid参数:可选,指定PID参数,如果在授权时有设置了默认的PID,则可忽略本参数。


3、relationId 参数: 可选,您的渠道ID,参考万能转链接口hcapi参数。


4、tpl参数:可选,默认1,用于指定模板,如果您想使用模板2二维码图,则用 tpl=2 参数。


5、addtxt 参数: 默认无最后一行,您可以加一行文字,比如“加微信XX领取奖品”,则调用接口如下:

http://api.veapi.cn/tbk/qrpic?vekey=V0xxxxxxx&para=€2A0a0zOy1Jg€&addtxt=加微信XXX领取奖励

模板3中“获得鸭粮:1232个”也可以用addtxt参数来指定。

6、showcp 参数(模板2和模板3本参数无效):此参数仅对“模板1”的有优惠券产品生效,即在图处上打印很显眼的优惠券小图(红底白字)。比如上面的示例:

默认是显示的(即showcp=1)当您不想显示它时,则传递参数showcp=0,当取消显示优惠券时,则会在文字部分提示优惠券金额。如下图:

示例:

http://api.veapi.cn/tbk/qrpic?vekey=xxxx&para=€2A0a0zOy6Jg€&addtxt=加微信&showcp=0


7、nocptxt参数(模板2和模板3时,本参数无效) 适用于无券产品,是否在下文提示“(无优惠券)”,如下:


默认是有提示,当设置nocptxt=0时则无券产品不提示。示例:

http://api.veapi.cn/tbk/qrpic?vekey=V0xxxxxxxxx&para=€fz120zm1dZY€&nocptxt=0


8、pic参数:自已指定主图的网络地址(比如 http://www.veapi.cn/x.jpg),如果不传递本参数,生成的发单图默认是用第一张主图。如果传了pic参数,指定自己的图片网址,那么就会使用该图做发单图。


9、onlyurl 参数: 正常返回值是包含pic(发单图网络地址)和copy_tkl_url(复制淘口令的网址)两项,如果您希望只返回 copy_tkl_url 一项(有的客户希望自己生成发单图则只需这个返回值即可),那么请传参 onlyurl=1 


10、domain参数:如果您要使用你自己的域名,可以指定本参数,值如:domain=www.veapi.cn,或domain=https://www.veapi.cn 注意:您自己的域名,需解析到指定的IP上。


11、wxurl参数:可选值1,默认的接口生成的防封图所携带的复制淘口令网页是我们自定义的带图片的网址,如果你添加了参数 wxurl=1参数,则使用微信自己的网址,生成如下图所示效果,该网址美观不足,但永远不会被微信封锁,毕竟是微信自己的网址。

在某些紧急情况下,你可以使用本参数wxurl=1,这样生成的复制淘口令网址效果如下:

12、appkey 和 secret 参数: 这2个参数,是提供你自己的应用密钥(淘宝开放平台——应用管理)生成淘口令,这更稳定安全。如果你提供了notkl参数,则不需要这2个参数。

【TIP】在双11等高负载场合,联盟有可能出问题,比如淘口令不弹窗,那么请加上这2个参数,避免生成的淘口令受别人影响。就可以解决淘口令问题。如何申请淘口令权限,参考http://wsd.591hufu.com/taokelianmeng/443.html



以下参数为模板3(参数tpl=3)专用:

1、logo :仅模板3有效,必选参数,图片底部左侧LOGO图,限250x68像素.

2、qrlogo :仅模板3有效,可选参数。二维码中间的小icon(小正方形logo),限69x69像素.

3、imgCoupon:仅模板3有效,可选参数。是否在主图右下角显示优惠券金额,当参数needImgCoupon=false时本参数值强制为false

4、needImgCoupon :仅模板3有效,可不设置或指定值'false',是否显示主图外圈优惠券背景图(参考imgCouponBorder参数).设置值为'false',则主图外圈中不显示优惠券包边图。当指定本参数为'false'时,则参数imgCoupon也强制为'false'即不在主图右下角显示优惠券面额。

5、imgCouponBorder:仅模板3有效,提供自己的发单图中的主图外圈优惠券背景图片网络地址,图片限686x686像素,且中间为透明,避免遮挡主图。当提供本参数时则needImgCoupon参数失效,默认是http://wsd.591hufu.com/public/images/qrcodemodel/model3/model_1.png  ,


【模板3调用API示例】

(1)正常调用模板3:

http://api.veapi.cn/tbk/qrpic?vekey=xxxxx&para=588147219322&tpl=3&addtxt=获得鸭粮:1232个&logo=http://wsd.591hufu.com/public/images/qrcodemodel/model3/logodemo.png&qrlogo=http://wsd.591hufu.com/public/images/qrcodemodel/model3/logo2demo.png


(2)不在主图上显示券后价:添加needImgCoupon=false&imgCoupon=false参数。

无券商品推荐做法:

http://api.veapi.cn/tbk/qrpic?vekey=xxxxx&para=558069588155&tpl=3&needImgCoupon=false&imgCoupon=false&addtxt=获得鸭粮:1232个&qrlogo=http://wsd.591hufu.com/public/images/qrcodemodel/model3/logo2demo.png


【返回值】

JSON,图片的URL地址

{

    "pic": "http://api.veapi.cn/tbk/public/...../0xxxxx.jpg",

    "copy_tkl_url": "http://url.vephp.com/pgmd...."  #复制淘口令的网址

}


如果调用包含了参数onlyurl=1,那么返回值:


{

    "copy_tkl_url": "http://url.vephp.com/pgmd...."  #复制淘口令的网址

}


返回值说明:

1、pic 指这个二维码发单图的网络地址,它保存于本站的服务器。

2、copy_tkl_url 指二维码中复制淘口令的网页地址。特殊情形直接使用这个网址。


【注意】请及时保存到您自己的服务器,网站每3-5天清理一次,因此,您取得图片地址后,还需要自己保存到本地服务器。


二、生成自提供链接(需为淘客推广链接)的发单二维码图

如果你是要生成自己的淘客推广链接的二维码中间页图,比如聚划算拼团链接(只要是s.click和uland.taobao.com都支持)

先看以下示例:

这个是聚划算拼团的淘口令二维码图,扫码后(图中二维码为避免被乱用,已隐藏)会进入如下中间页面:


复制后打开手机淘宝,就进入拼团页面。


以上是二维码图的整个流程,接口地址和方式1的接口一样都是“qrpic”,只是参数不同。

下面是接口调用和参数:


【接口调用】

http://api.veapi.cn/tbk/qrpic?vekey=xxx&url=必须提供拼团网址&其它参数=...


参数(本接口不需要传para参数,而是url参数必传):


(1)url 参数: 必选。聚划算活动地址,一般是https://s.click.taobao.com/t?e=m%3y...  参考拼团接口:http://wsd.591hufu.com/doc/pintuanjiekou

(2)title参数:可选。默认会使用拼团产品的标题,你可以直接提供本参数自己指定标题。它也是生成的淘口令标题。

(3)info参数:可选,自定义的标题下的黑色说明文字,比如上图中“聚划算大拼团”。

(4)addtxt参数:图片中最后一行的小字号说明,参接口方式1。你可以用本参数附加一行说明。

(5)pic参数: 可选。默认使用聚划算产品主图,可以自己指定一个图片。

(6)itemid参数:可选,如果url参数不能被解密,可以使用本参数传递产品ID,方便接口提取标题和主图信息。


【返回值】

{

    "pic": "http://wsd.591hufu.com/public/....aaa.jpg",

    "copy_tkl_url": "http://url.vephp.com/df..."

}


返回值中pic是生成的二维码图图片地址,你可以直接在微信上发给客户,最好采集到你的服务器,平台每3-5天清空一次。

返回值copy_tkl_url 是复制淘口令的地址。


现在,试着把二维码发单图整合到您的应用中吧,给微信客户推送!


三、错误码:

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

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部