维易淘客联盟接口开发文档:二维码发单图

二维码发单图

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

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

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


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

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


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


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


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

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

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

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


二维码发单图简介【2套模板,可定制模板】

先看一下二维码效果图:

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

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


     


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

    



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

1、有优惠券的产品:

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

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

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


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


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



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

http://apiqr.vephp.com/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://apiqr.vephp.com/qrpic?vekey=V0xxxxxxx&para=€2A0a0zOy1Jg€&addtxt=加微信XXX领取奖励

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

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

示例:

http://apiqr.vephp.com/qrpic?vekey=V0xxxxxxx&para=€2A0a0zOy6Jg€&addtxt=加微信&showcp=0


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


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

http://apiqr.vephp.com/qrpic?vekey=V0xxxxxxxxx&para=€fz120zm1dZY€&nocptxt=0


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


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


【返回值】

JSON,图片的URL地址

{

    "pic": "http://api.vephp.com/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://apiqr.vephp.com/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 是复制淘口令的地址。




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

 

客服

关注