接口使用场景等说明:【特别公告】
抖音精选联盟官方平台于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 | 暂无 |
参数名称 | 参数类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
vekey | String | 是 | V123M56 | 公共参数,接口秘钥,请在会员中心获取 |
refresh_token | List | 是 | 684f855c-3c2b-44ff-89c8-1d134c206d25 | 上次用户授权返回的refresh_token值,可以批量提供,用英文逗号相连。每次最多传递50个refresh_token |
GET/POST http://api.veapi.cn/douke/refreshToken?vekey=xxx&refresh_token=684f855c-3c2b-44ff-89c8-1d134c206d25,184f855c-3c2b-44ff-89c8-1d134c206d21
$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; //返回值
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); } }
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
参数名称 | 参数类型 | 示例值 | 描述 |
---|---|---|---|
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" }