API文档中心

热门接口:产品ID找同款全量维权查询万能转链字符串ID转换 (有API需求可联系本站)

授权指南

当您需要多用户/企业版授权,或者渠道授权,请参考这篇内容。


您有两种方法可以授权:
方式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用户新的sessionkey700015125581......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个字段:errorerror_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一起做为参数。

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部