API文档中心

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

多用户和企业版会员批量刷新token接口

调用权限:核心接口会员卡调用
接口使用场景等说明:

【特别公告】

抖音精选联盟官方平台于3月13日关闭,请参考 https://www.veapi.cn/gonggao/detail_84.html 


做为平替,将由穿山甲接口替代,佣金直接在本站会员中心结算。

详情见穿山甲API说明 https://www.veapi.cn/apidoc/douyindouke/369 



由于抖客的授权有效期只有7天,本接口用于提供给维易的“多用户和企业版”会员卡,多用户版会员在管理自己的用户token时,可以定时批量刷新token接口,保持用户的access token有效性。


使用场景:

1、在 access_token过期时,使用 refresh_token可以获取新的acces_token 和 refresh_token;可以保证一直是有效的access_token。

2、access_token有效期7天,refresh_token用于刷新access_token的刷新令牌,refresh_token有效期:14 天;


抖客对access_token更新策略:

1.、在 access_token 过期前1小时之前,ISV使用 refresh_token 刷新时,会返回原来的 access_token 和 refresh_token,但是二者有效期不会变;

2、在 access_token 过期前1小时之内,ISV使用 refresh_token 刷新时,会返回新的 access_token 和 refresh_token,但是原来的 access_token 和 refresh_token 继续有效一个小时;

3、在 access_token 过期后,ISV使用 refresh_token 刷新时,将获得新的 acces_token 和 refresh_token,同时原来的 acces_token 和 refresh_token 失效;


您的刷新策略:

基于抖客精选联盟的token更新策略,您可以每个小时刷新一次即可。因为新旧access_token 交替时,旧access_token还能保持一小时有效,这意味着在过期前一小时和过期后一小时,总共2小时时间跨度,只要您在这2小时内有刷新就可以。因此也不会导致token因为刷新空档导致失效。

请在刷新后,务必保持新的access_token和refresh_token 以及expires_in 。

接口请求地址

环境 http 地址 https 地址
正式环境 http://api.veapi.cn/douke/refreshToken 暂无

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String V123M56 公共参数,接口秘钥,请在会员中心获取
refresh_token List 684f855c-3c2b-44ff-89c8-1d134c206d25 上次用户授权返回的refresh_token值,可以批量提供,用英文逗号相连。每次最多传递50个refresh_token

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/douke/refreshToken?vekey=xxx&refresh_token=684f855c-3c2b-44ff-89c8-1d134c206d25,184f855c-3c2b-44ff-89c8-1d134c206d21 

使用curl函数,curl不是php原生库,需要安装才能使用

$api="http://api.veapi.cn/douke/refreshToken?vekey=xxx&refresh_token=684f855c-3c2b-44ff-89c8-1d134c206d25,184f855c-3c2b-44ff-89c8-1d134c206d21";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api);
//curl_setopt($ch, CURLOPT_POST, true);  //POST方式时启用
//curl_setopt($ch, CURLOPT_POSTFIELDS, $postData );  //POST方式时传参

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true );   //返回数据流,不直接输出
curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快
curl_setopt($ch, CURLOPT_TIMEOUT, 6);  //允许执行的最长秒数。这里设定6S
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);

$result = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);

echo $result; //返回值
使用okhttp3/httpclient/jsoup/hutool,以hutool为例:

import cn.hutool.http.HttpResponse;
import cn.hutool.http.HttpRequest;

public class testGetParam {

    public static void main(String[] args) {
        // API网址
        String url = "http://api.veapi.cn/douke/refreshToken?vekey=xxx&refresh_token=684f855c-3c2b-44ff-89c8-1d134c206d25,184f855c-3c2b-44ff-89c8-1d134c206d21";
        // JDK 8u111版本后,若目标页面为HTTPS协议,请启用proxy用户密码鉴权
        //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");

        // 发送请求
        String result = HttpRequest.get(url)
                .timeout(10000)//设置超时,毫秒
                .execute().body();
        System.out.println(result);
    }
}
推荐使用 requests,支持访问http,https网页:

import requests
		
# 要访问的API网页
target_url = "http://api.veapi.cn/douke/refreshToken?vekey=xxx&refresh_token=684f855c-3c2b-44ff-89c8-1d134c206d25,184f855c-3c2b-44ff-89c8-1d134c206d21"

# 发送请求
response = requests.get(target_url)

# 获取页面内容
if response.status_code == 200:
	print response.text

返回值(JSON)

参数名称 参数类型 示例值 描述
old_refresh_token String e1ef3073-53d7-636a-be2b-10cd95a24166 参数中传入的refresh_token,当批量查询时,可用该字段判断每组返回值对应归属于参数中的refresh_token处理结果值。
access_token String c1a1a7d3-6f72-6e73-91bb-255a21f26d87 对old_refresh_token刷新后生成新的access_token,请参考上文场景描述中的授权策略说明。
expires_in Int64 530808 access_token剩下的有效时间;Unix时间戳:秒。
refresh_token String ed14a713-1f27-6a0b-9b94-759262744ec8 用于刷新access_token的刷新令牌(有效期:14 天)
scope String SCOPE 权限范围(已废弃)
shop_id Int64 23323 店铺ID
shop_name String 测试店铺 店铺名称
authority_id String 1321324 授权ID,店铺授权为店铺id,达人授权为达人id;
auth_subject_type String WuLiuShang 授权主体类型

返回示例

【提示】推广链接通常有时效性,示例中的链接为创建文档时生成,仅用于展示返回结果使用,有可能已失效。
{ "error": "0", "msg": "refresh_token 批量刷新完毕!", "success_num": 1, "fail_num": 0, "data": [ { "old_refresh_token": "e1ef3073-53d7-436a-be2b-10cd95a24166", "access_token": "c1a1a7d3-6f72-4e73-91bb-255a21f26d87", "auth_subject_type": "DouKe", "authority_id": "7213597798095225100", "expires_in": 535455, "refresh_token": "e8ef3076-53d7-436a-be9b-00cd95a24166", "scope": "SCOPE", "shop_id": 0, "shop_name": "" } ], "request_id": "ZW1SZSl" }

错误码

如果error不为0时,请点此查看错误码表格

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部