维易客户在调用“淘宝客渠道信息备案(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 | 用户新的session | 700015125581......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即可。