如何使用维易渠道工具接口给你的用户(渠道方)授权?

时间:2022-03-15 35799 主题:淘客开发教程
导读《如何使用维易渠道工具接口给你的用户(渠道方)授权?》要点:授权网址:http://api.vephp.com/auth?vekey=你的VEKEY&state=你要传的参数使用方法:在你的网站或应用中授权的地方调用上述授权网址,当你的代理或客户授权后,会跳回到您设置的回调网址(在授权页中设置“渠道方帐号授权回调网址”),并携带你在授权网址中设置的state参数回传,可以自行进后续处理

维易客户在调用“淘宝客渠道信息备案(publishersave)”接口时,需要让您的客户授权给维易,这样维易才能给您备案,

参考此文档:http://wsd.591hufu.com/doc/taokequdaojiekou 

那要如何在您的网站上整合授权功能给您的用户(渠道方)使用?


您有两种方法可以给渠道方授权:

方式1:授权后自动跳转到你的回调接收网址上,把授权后的session等参数回传给你,方便你的保存。
方式2:手动授权方式,需要手动复制session,不推荐。


您的渠道方授权后请保管好session,调用接口时传给参数accesstoken即可。


【说明】渠道授权只需要第1次生成渠道ID前授权即可,一旦为你的客户生成渠道ID后,就不需要再授权了。


方式一:回调方式(推荐)

授权接口:http://api.vephp.com/auth?vekey=xxx&state=你要回传的参数&recall_url=http://....
使用流程和方法:

1、在你的网站或应用中授权的地方调用上述授权接口,拿到淘宝授权网址。

2、跳转到该淘宝网址进行授权。

3、当你的代理或客户授权后,维易系统在解析完淘宝传回的授权code后,会跳回到您设置的回调网址(在维易会员中心的授权页中设置“渠道方帐号授权回调网址”或recall_url参数), 跳回到你设置的回调页时,将携带你在授权网址中设置的state参数回传,

4、您自己根据回传的授权sessionkey和userid等值,以及state参数对应保存到相应的会员名下,自行进行后续处理。
参数说明:

参数含义是否必选默认值,可选值
vekey你在本站的vekey必填你的主号授权后得到的值
state你需要在授权后回传到你回调页处理的参数选填比如你的会员id,也可不提供本参数
recall_url回调URL,用于接收维易回传的渠道方授权后的session等信息必填如果多用户版,可以在维易会员中心
view
授权终端界面风格,web指电脑端,wap指移动端选填默认web手机端授权请指定view=wap


调用接口后,返回一个淘宝授权网址,格式如下:

https://oauth.taobao.com/authorize?response_type=code...

获取到这个网址后,你可以直接跳过去授权,也可以用采集方式先抓取这个淘宝授权页内容,并修改一些内容后再输出,比如:

1、直接跳转到这个页面让你的客户授权。

2、也可以先抓取这个页的内容,替换掉一些内容,比如页面上的LOGO换成你们自己的,再输出。



授权后返回内容:

一、授权成功后返回值:

你的客户授权后,我们将返回到您设置的回调网址上,形式如:

http://www.你的回调网址.com/reauth?session=700....&ext_time=153..&user_id=123&user_nick=淘宝昵称&state=您的参数

这里假定上面的“http://www.你的回调网址.com/reauth”是你设置的回调网址,而后面的参数是我们返回的。
参数详解(表中的“用户”是指您的代理或渠道方帐号):

参数含义示例
session用户新的session700015125581......556212
ext_time本次授权过期时间,一般是30天后带3位毫秒的时间,如:1538050658141,可以去掉后三位毫秒保存
user_id用户的淘宝userid如215694889
user_nick用户的淘宝昵称如:维易淘客
state您设置的自定义参数您在第一步设置的参数原样带回,如:您的会员ID

上面回调网址,“http://www.你的回调网址.com/reauth ”是示例,具体需要您在本站授权页设置(多用户版)或用参数recall_url传参。
(1)您可以设置一些验证参数,比如:http://www.你的回调网址.com/reauth?key=123123 ,

那么我们会把session、ext_time等其它参数附回到后,如http://www.你的回调网址.com/reauth?key=123123&session=700....&ext_time=....
(2)如果您在回调地址上不带参数,则返回参数直接用"?"附加到后面。如上例的http://www.你的回调网址.com/reauth?session=7000... 


二、授权失败返回值:

如果授权失败,或授权码解析失败,我们将在你的接收回调页url的GET信息中回传2个字段:

error

error_description

您可以在回调页,保存这2个字段信息做为日志以便后台自己查看,也可以直接输出给用户提示,这样一旦用户向您反馈时,可以直接截图给您。

比如您将收到这样的URL:

http://www.你的回调网址.com/reauth?error=access_denied&error_description=parent%20account%20should%20authorize%20in%20web%20way%20first.&state=BDR...

这提示了该授权号是子帐号,不能用于授权,除非其父帐号同意。

parent account should authorize in web way first.



方式二:手动方式

此方式需要授权后手动复制给你的代理或客户。如果您没有提供回调地址,则只能使用本方式给您的渠道方客户授权。
请复制短网址给代理授权: http://t.cn/Ai9QPut6 
您的渠道方授权后请保管好session,调用接口时传给参数accesstoken即可。



淘客标签:渠道方授权
淘客/抖客/多多进宝专题

暂无淘宝客专题教程


在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部