淘宝开放平台

登录
文档中心 > API类目 > 人工智能实验室开放平台API

人工智能实验室开放平台API

alibaba.ailabs.tmallgenie.auth.refresh (刷新token)

通过此接口刷新天猫精灵授权token

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
refresh_token_request TopRefreshReqDto 可选 refresh_token_request
  • └ client_id
  • String
  • 可选
  • RFBN
  • clientId
  • └ scope
  • String
  • 可选
  • basic
  • 只支持“basic”
  • └ grant_type
  • String
  • 可选
  • refresh_token
  • 只支持“refresh_token”
  • └ refresh_token
  • String
  • 可选
  • YHNB
  • refreshToken
  • └ uuid
  • String
  • 可选
  • DDEDFF8257237D951DBB26DD32A63619
  • 设备uuid

响应参数

名称 类型 示例值 描述
access_expires_in Number 5000 access token过期时间，相对时间，单位为秒
access_token String TGBC access_token
refresh_expires_in Number 5000 refresh token过期时间，相对时间，单位为秒
refresh_token String THVB refresh_token

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAilabsTmallgenieAuthRefreshRequest req = new AlibabaAilabsTmallgenieAuthRefreshRequest();
AlibabaAilabsTmallgenieAuthRefreshRequest.TopRefreshReqDto obj1 = new AlibabaAilabsTmallgenieAuthRefreshRequest.TopRefreshReqDto();
obj1.setClientId("RFBN");
obj1.setScope("basic");
obj1.setGrantType("refresh_token");
obj1.setRefreshToken("YHNB");
obj1.setUuid("DDEDFF8257237D951DBB26DD32A63619");
req.setRefreshTokenRequest(obj1);
AlibabaAilabsTmallgenieAuthRefreshResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<alibaba_ailabs_tmallgenie_auth_refresh_response>
    <access_expires_in>5000</access_expires_in>
    <access_token>TGBC</access_token>
    <refresh_expires_in>5000</refresh_expires_in>
    <refresh_token>THVB</refresh_token>
</alibaba_ailabs_tmallgenie_auth_refresh_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
500 刷新token失败，可能是token错误或者token已经超时 重新进行授权
500005 刷新token频率过快 单个设备刷新token的频率不应该超过10分钟一次

API工具

API测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部