文档首页 > > API参考> 应用侧API参考> 应用安全接入> 刷新token

刷新token

分享
更新时间: 2019/11/12 GMT+08:00

接口说明

应用服务器通过鉴权接口获取到的accessToken是有有效时间的,在accessToken快过期时,应用服务器通过调用此接口,获取新的accessToken。

URI

请求方法

POST

URI

/iocm/app/sec/v1.1.0/refreshToken

传输协议

HTTPS

请求参数

参数

必选/可选

类型

位置

描述

appId

必选

String(256)

body

访问物联网平台的应用ID,在物联网平台创建应用时由平台分配获得。

secret

必选

String(256)

body

访问物联网平台的应用密钥,与appId对应,在物联网平台创建应用时由平台分配获得。

refreshToken

必选

String(256)

body

刷新token,用来获取一个新的accessToken。refreshToken在调用鉴权接口或刷新token接口时获得。

响应参数

Status Code: 200 OK

参数

类型

描述

scope

String(256)

申请的权限范围,参数值固定为default。

tokenType

String(256)

鉴权token的类型,参数值固定为Bearer 。

expiresIn

Integer(256)

accessToken的有效时间,参数值固定为3600秒。

accessToken

String(256)

鉴权参数,访问物联网平台API接口的凭证。

refreshToken

String(256)

鉴权参数,有效时间为24小时,用于“刷新Token”接口。当accessToken即将过期时,可通过“刷新Token”接口来获取新的accessToken。

请求示例

POST https://{host}:{port}/iocm/app/sec/v1.1.0/refreshToken
Content-Type: application/json

{
  "appId": "******",
  "secret": "******",
  "refreshToken": "******"
}

响应样例

Status Code: 200 OK
Content-Type: application/json

{
  "accessToken": "*******",
  "tokenType": "*******",
  "expiresIn": "*******",
  "refreshToken": "*******",
  "scope": "*******"
}

错误码

Http状态码

错误码

错误描述

说明

400

100449

The device is freezed cant operate.

用户无操作权限。

处理建议:请检查appId所对应用户是否有接口调用权限。

400

102202

Required Parameter is null or empty.

必选参数为空。

处理建议:请检查请求参数中的必选参数是否已填写。

400

50400

The input is invalid.

输入参数无效。

处理建议:请检查接口调用请求中携带参数的合法性。

401

100208

AppId or secret is not right.

appId或secret错误。

处理建议:

  • 请检查appId和secret是否有误,是否新增字符或缺少字符。
  • 请检查请求路径中的IP地址是否有误。

500

50252

Internal server error.

服务器运行内部错误。

处理建议:物联网平台内部错误,请联系物联网平台维护人员处理。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区