维易客户在调用“淘宝客渠道信息备案(publishersave)”接口时,需要让您的客户授权给维易,这样维易才能给您备案,
参考此文档:http://wsd.591hufu.com/doc/taokequdaojiekou
那要如何在您的网站上整合授权功能给您的用户(渠道方)使用?
方式1:授权后自动跳转到你的回调接收网址上,把授权后的session等参数回传给你,方便你的保存。
方式2:手动授权方式,需要手动复制session,不推荐。
您的渠道方授权后请保管好session,调用接口时传给参数accesstoken即可。
【注意】授权有效期是30天,授权后请在30天完成备案,否则需要重新授权。
授权网址:http://api.vephp.com/auth?vekey=你的VEKEY&state=你要传的参数
使用方法:在你的网站或应用中授权的地方调用上述授权网址,当你的代理或客户授权后,会跳回到您设置的回调网址(在授权页中设置“渠道方帐号授权回调网址”或下述recall_url参数), 并携带你在授权网址中设置的state参数回传,可以自行进后续处理。
参数说明:
参数 | 含义 | 是否必选 | 默认值,可选值 |
---|---|---|---|
vekey | 你在本站的vekey | 必填 | 你的主号授权后得到的值 |
state | 你需要在授权后回传到你回调页处理的参数 | 选填 | 比如你的会员id,也可不提供本参数 |
recall_url | 回调URL,用于接收维易回传的渠道方授权后的session等信息 | 必填 | 如果多用户版,可以在维易会员中心 |
view | 授权终端界面风格,web指电脑端,wap指移动端 | 选填 | 默认web手机端授权请指定view=wap |
返回内容:
你的客户授权后,我们将返回到您设置的回调网址上,形式如:
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...
此方式需要授权后手动复制给你的代理或客户。如果您没有提供回调地址,则只能使用本方式给您的渠道方客户授权。
请复制短网址给代理授权: http://t.cn/E2JV4OJ
您的渠道方授权后请保管好session,调用接口时传给参数accesstoken即可。