Help Center> IoT Device Access> API Reference> 历史API> 应用侧API参考> 设备接入应用侧API参考> 应用接入认证> 鉴权
View PDF

鉴权

接口说明

  • 应用服务器接入物联网平台前，需调用此API获取鉴权信息，接入平台。随后携带鉴权信息调用其他应用场景。
  • 应用服务器在授权过期后，需向物联网平台获取新的鉴权信息。

注意事项

鉴权时使用的key和secret是物联网平台产生的app ID和密码。

URI

请求方法

POST

URI

/api/v3.0/auth/tokens

传输协议

HTTPS

请求参数

名称

必选/可选

类型

位置

说明

key

必选

String(256)

Body

应用ID。

secret

必选

String(256)

Body

应用密钥。

响应参数

名称

类型

说明

accessToken

String

访问令牌。

expiresIn

Integer

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

refreshToken

String

刷新令牌，用来刷新accessToken（1个月的有效期）。

scope

String

申请的权限范围，当前不支持配置权限，默认有所有权限。

tokenType

String

鉴权token类型，当前仅支持bearer类型。

请求示例

POST https://{host}:{port}/api/v3.0/auth/tokens
Content-Type: application/json

{
  "key" : "******",
  "secret" : "******"
}

响应示例

Status Code: 200 OK

Content-Type: application/json

{
  "accessToken" : "string",
  "expiresIn" : 0,
  "refreshToken" : "string",
  "scope" : "string",
  "tokenType" : "string"
}

错误码

HTTP状态码

HTTP状态码说明

错误码

错误码描述

200

OK

100203

The application is not existed.

处理建议：校验并输入有效的App ID

400

Bad Request

102833

The user is freezed cant operate.

处理建议：您已欠费，请去公有云续费

401

Unauthorized

100208

AppId or secret is not right.

处理建议：校验并输入有效的App ID和密码。
父主题： 应用接入认证