【接口请求方式】GET方式(图片传输过程中提交图片或者二进制数据时才使用post)
3、接口参数说明:
(一)公共参数:、para
1、参数vekey:所有接口都需要,用于验证你调用此接口的权限。
2.参数para:基本涵盖了淘客所有场景,参考上文提到的8种para参数,在辅助界面,有对应的参数规范要求:
(1)在ID转淘宝密码接口中,para需要传入产品ID
(2)在淘宝密码转淘宝密码接口中,para需要传递别人的淘宝密码,接口会把它转换成你的淘宝密码。
(3)在链接淘宝密码的接口中,para需要传递二合一链接或者s.click链接。
【注意】使用频道ID时,必须满足两个关键点:
1.使用专属通道PID或者成员专属PID。
2.传递参数指定通道rid。
满足以上两个条件后,调用链接下单,即可使用下单接口指定=2来查询渠道订单。
(二)其他非必要参数:
完整URL接口地址:
vekey=你的¶=主要参数&pid=&sina=1&=1&=71005..&=bdsaf..
1、pid:可选,值为,如果你已经在会员中心设置了默认pid,不需要更改pid,则不需要传递此参数,接口会默认调用你设置的pid,如果需要更改为同一个淘客账号下的其他pid,则传递pid参数即可。
但如果您是多用户版本的用户,您在本站授权并设置Pid的淘宝账号为主账号,您的代理或者主账号以外的子账号调用接口时,必须传递pid参数以及下方的参数。
【很重要】
(1)当您使用渠道ID时,请不要使用“渠道专属PID”,请进入淘宝联盟后台“推广管理-渠道管理-渠道专属PID”。
(2)当您使用会员操作ID绑定订单时,请不要使用“会员专属PID”。
2.(注意大小写):选填,渠道关系ID值,适用于渠道推广场景,普通链接转移无需此参数
3、淘宝联盟授权字符串,该参数只对多用户版本有效,如果你的接口卡是多用户版本,并且使用非默认账号来调用,比如你的代理公众号,需要传入淘宝联盟账号授权,以及账号下的pid。
4.可选项,0(默认值)或1。0或不设置表示不显示具体商品信息,指定值为1则显示商品信息。如果需要高佣金转账接口返回更详细的商品信息,不需要调用其他接口,直接传递参数即可。结果对比请参考下方“返回值”。
5.【重要】可选,接口会自动检测参数中是否包含卡券ID,您也可以直接指定卡券ID。
6.sina:可选,值为0(或不设置)或1。表示是否将链接生成的短链接转为新浪短网址,默认为0或不设置即为淘宝短网址,例如:
https://s.click.taobao.com/lWz8kQw
如果传递了&sina=1,它将生成:
http://t.cn/RBFwwuT
短网址主要用于QQ群推送或者微信推送,如无必要,可以不用发送sina参数。
【下面两个参数6、7会提高你的程序效率】
7.notkl:选填值【重要】,值1:接口会默认返回淘宝密码(字段),主要是为了方便一些早期没有淘宝联盟基础API接口的客户,如果您有淘宝基础API权限和SDK包,使用该参数取消接口直接返回淘宝密码,在自己的程序中在返回值中生成长链接的淘宝密码,强烈建议使用该参数,提高您高佣金接口调用的效率。
8.可选值【重要】,值为1:接口默认返回短链接(字段)。如果您不需要此字段,或者您有淘宝基础API权限和SDK包,可以使用此参数取消接口返回短链接,根据需要在返回值中为长链接生成短链接。强烈建议使用此参数,可以提高您高佣金接口调用的效率。
9. :可选,值固定为1,或者不传。当商品有优惠券时,但有时可能只需要s.click链接,也就是想算淘宝推广佣金,但不需要领取优惠券。那么就加上此参数,就可以获取s.click链接了。
【注意】该参数生成的短链接主要用于网络软文或者论坛帖子推广,不适合在微信上推广(微信主要靠图片防封,否则由于众所周知的腾讯和阿里互相封禁的原因,直接通过短链接解析出来的淘宝推广链接在微信或者QQ上是打不开的)。
如果你需要在微博上推广,你需要以下微博参数
10.weibo:选填,固定值1,或者不传,如果需要在微博推广,并在微博帖子中包含淘客推广网址,则添加此参数,生成新浪短网址,避免新浪微博屏蔽,跳转淘客推广链接。
【注意事项】 使用前须知
1、由于新浪已停止对外使用短网址并限制其频率,添加该参数会降低接口性能,有时可能需要1-5秒以上才能返回值。
2、使用该参数后,接口限制为每分钟25次。
3、该参数获取的信息只适用于微博推广,不适用于微信、QQ等腾讯应用。
4.如果需要在其他网站推广以便百度收录软文推广的短链接,建议使用参数高效生成短链接,不建议使用微博参数
10.me:营销计划链接中的me参数一般不用。
11、淘宝密码主图:接口中不指定notkl参数时,默认返回淘宝密码,淘宝密码默认主图为商品在淘宝天猫的第一张主图,如果您设置参数并提供自定义网络主图,生成的淘宝密码将以您提供的图片地址作为封面。
12.card:指定卡识别码(所有接口通用)。当您的账户下有多张卡时,系统默认按照“多用户版--->年卡或月卡--->点卡”的顺序使用。如果您想使用优先级较低的卡,例如点卡,可以传递此参数,其值为卡识别码。具体参考“更多帮助”第4节
4.返回值:
返回值格式:json
分为简要版和详细版。
【注意】
1、下面两个返回值都包含推广链接和三个已经转换成您的PID的值,您可以直接分发给客户使用。
2.在返回值中,当商品没有优惠券时,字段会比有优惠券的少,所以你的程序需要做判断,避免出错。你也可以用它来判断是否有优惠券:
比如在PHP中需要做if(!empty($re[''])){ ...... }的判断,当这个字段不存在或者为空的时候,就代表这个商品没有优惠券。
若用于判断是否有优惠券:1-表示该产品有优惠券,2-表示该产品没有优惠券。
返回值如下:
1.没有参数的时候:如图
(1)可用优惠券:
2018年8月20日左右,接口上线了最新的妈妈券返回值字段,例如以下以“mm_”开头的字段:
详情请参阅
(2)无优惠券:
链接为原版高佣二合一链接,跳转至优惠券页面后会提示优惠券已兑换。
建议使用此方法。您无需进入优惠券页面,而是直接进入产品页面,从而提供更好的体验。
这两个字段根据你的需求来选择。
(3)商品下架或非淘客联盟商品的退货:
2.提供参数时:如图
表示是否有优惠券:1-表示产品有优惠券,2-表示产品没有优惠券
: 类别编号
:您的二合一链接(有优惠券的商品)或者s.click链接(无优惠券的商品)链接转移后,可以直接使用
:优惠券有效期(有优惠券时才有此字段)
:优惠券信息,格式为“消费满xx元减xx元”(有优惠券时才有此字段)
:剩余优惠券数量,为0时,优惠券无效。(有优惠券时才有此字段)
:优惠券开始时间(有优惠券时才有此字段)
:发放优惠券总额(有优惠券时才有此字段)
:优惠券类型:1公共优惠券,2私人优惠券,3妈妈优惠券(有优惠券时此字段才可用)
:该产品佣金比例,多级代理按此值计算,10代表10%。
: 产品编号
:淘宝密码,此密码已转换成你自己的PID密码,可直接使用
:短链接如QQ推广等场景,已经转换成您自己的PID密码,可直接使用。
:无优惠券时商品原有二合一链接。(此字段仅在无优惠券时才有,不建议使用,仅返回原始数据,直接使用会提示优惠券无效)
【其他详细版本参数】
title:产品标题
:产品折扣价
: 原价
:过去 30 天的销售量
: 分类名称
:子叶分类
:卖家id
:1,代表天猫,0,代表淘宝
:产品库类型,支持多种库类型,以“,”分隔 1:表示营销产品主库
:表示商品链接地址(部分天猫国际商品也是链接,请一并分析)
5.错误返回值:
当找不到商品或者发生错误时,返回值json如下:
{ "error": "1", "msg": "请传递产品ID、或淘口令,或淘客链接" }
扫一扫在手机端查看
我们凭借多年的网站建设经验,坚持以“帮助中小企业实现网络营销化”为宗旨,累计为4000多家客户提供品质建站服务,得到了客户的一致好评。如果您有网站建设、网站改版、域名注册、主机空间、手机网站建设、网站备案等方面的需求,请立即点击咨询我们或拨打咨询热线: 13761152229,我们会详细为你一一解答你心中的疑难。