文档首页 > > API参考> 应用侧API参考> 应用接入认证> 鉴权

鉴权

分享
更新时间: 2019/09/24 GMT+08:00

接口说明

  • 应用服务器接入物联网平台前,需调用此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和密码。

500

Internal Server Error

100030

Auth fail on apigw.

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区