当您需要多用户/企业版授权,或者渠道授权,请参考这篇内容。
您有两种方法可以授权:
方式1:使用回调方式授权:多用户/企业版或渠道ID授权请使用这个。授权后自动跳转到你的回调接收网址上,把授权后的sessionkey等参数回传给你,方便你的保存。
方式2:手动授权(淘宝联盟):需要手动复制sessionkey。
【适合范围】
适合淘宝联盟、拼多多、唯品会等所有可用平台的授权!
【注意事项】
目前淘宝联盟、拼多多、唯品会等平台的授权,均为定期手动续期,无法刷新refresh_token,因此请注意过期时间,定期重新授权。
只有抖客的授权由本站系统自动刷新授权,可永久续期。对于多用户和企业版会员,自行管理抖客的授权,本站也提供了批量刷新授权的接口,参考https://www.veapi.cn/apidoc/douyindouke/349
【特别注意】
您在会员中心原先授权使用的联盟号,如果在渠道授权时,又再次使用该联盟号授权,就会导致会员中心的授权被挤掉而失效。因此,您在渠道授权后,发现调用接口提示“sessionkey过期或授权失效非法”的msg提示,那么就是因为渠道授权导致原会员中心的授权无效。
解决办法:
请到会员中心重新用该联盟号授权,并注意在渠道授权时,不要使用该联盟号授权。如果您是在开发程序中,可以使用别的联盟号测试渠道授权。
授权网址:
http://api.veapi.cn/tbk/auth?vekey=xxx&state=自定义参数&recall_url=http://....
使用方法:在你的应用中授权的地方调用上述授权接口,获取授权网址,你的代理或客户授权后,会跳回到您设置的回调网址recall_url, 并携带你在授权网址中设置的state参数回传,可以自行进行后续处理。
参数说明:
参数 | 含义 | 是否必选 | 默认值,可选值 |
---|---|---|---|
vekey | 你在本站的vekey密钥,如有secret也需要传 | 必填 | 你的维易号授权后得到的值 |
recall_url | 回调URL,用于接收回传的授权后session等信息 | 必填 | 您自己的网页,用于接收回传的参数 |
state | 你需要在授权后回传到你回调页处理的参数 | 选填 | 比如你的会员id,也可不提供本参数 |
view | 授权界面风格,指定电脑端或移动端 | 选填 | 默认值web,可选值wap移动端 对于京东联盟,该入参可使用以下可选值: snsapi_base(静默模式,登录+授权一步完成) snsapi_app_union_login(非拉端模式,APP直接打开H5授权页) 比如view=snsapi_base |
platform | 指定平台,默认淘宝联盟(默认参数值:tb) | 选填 | 可选值:tb(默认)淘宝联盟,jd京东联盟,pdd拼多多,vip唯品会,douke抖客,douyin抖音 |
rejson | 是否返回json格式,可选值0(默认)或1,强烈建议传入本参数 | 选填 | 由于历史原因,过去接口返回值直接返回授权链接的URL字符串,为了规范并且不影响在使用的旧用户,请传入本参数,返回值统一为JSON |
接口返回内容:
调用接口后,返回一个淘宝或拼多多或京东等平台的授权网址,格式如下:
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”是你在调用auth授权接口时设置的recall_url回调网址,而后面的参数是我们返回的。
参数详解(表中的“用户”是指您的用户):
参数 | 含义 | 示例 |
---|---|---|
session | 用户新的sessionkey | 700015125581......556212 |
ext_time | 授权过期时间(秒) | 如果是带3位毫秒的时间,如:1538050658141,可去掉后三位毫秒保存 |
user_id | 用户的淘宝userid | 如215694889 |
user_nick | 用户的淘宝昵称 | 如:维易淘客 |
state | 您设置的自定义参数 | 您在第一步设置的参数原样带回,如:您的会员ID |
上面回调网址,“http://www.你的回调网址.com/reauth ”是示例,具体需要您在本站授权页设置。
(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...
错误字段error_description值“parent account should authorize in web way first.”这提示了该授权号是子帐号,不能用于授权,除非其父帐号同意。
此方式需要授权后手动复制给你的代理或客户。如果您没有提供回调地址,则只能使用本方式给您的下级客户授权。
请复制短网址给代理授权: http://t.cn/Ai9QPut6
您的下级授权后请保管好sessionkey,调用接口时和pid一起做为参数。