设备接入 IoTDA设备接入 IoTDA

更新时间:2021/09/06 GMT+08:00
分享

刷新token

典型场景

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

接口功能

支持第三方应用在accessToken到期前,从物联网平台获取新的accessToken。

接口描述

1
AuthRefreshOutDTO refreshAuthToken(AuthRefreshInDTO arInDTO) throws NorthApiException

接口所属类

Authentication

参数说明

AuthRefreshInDTO

参数

必选/可选

类型

位置

描述

appId

必选

String(256)

body

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

secret

必选

String(256)

body

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

refreshToken

必选

String(256)

body

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

返回值

AuthRefreshOutDTO

参数

类型

描述

scope

String(256)

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

tokenType

String(256)

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

expiresIn

Integer(256)

平台生成并返回accessToken的有效时间,单位为秒。

accessToken

String(256)

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

refreshToken

String(256)

鉴权参数,用来刷新accessToken,refreshToken的有效时间为1个月。

错误码

Http状态码

错误码

错误描述

说明

400

100247

Operation not allowed. The application has been frozen.

应用冻结。

处理建议:请检查应用是否因为欠费冻结。

400

102202

Required Parameter is null or empty.

必选参数为空。

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

400

50400

The input is invalid.

输入参数无效。

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

401

100208

AppId or secret is not right.

appId、secret或refreshToken错误。

处理建议:

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

500

50252

Internal server error.

服务器运行内部错误。

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

分享:

    相关文档

    相关产品