文档首页/ 智能设施云平台/ API参考/ API列表/ Token管理/ 校验Token
更新时间：2025-08-19 GMT+08:00
查看PDF
分享

校验Token

功能介绍

应用服务器可调用此接口校验Token。

校验Token的结果中，包含用户ID、用户名等信息。

Token填写在头域X-Auth-Token中，搭配头域X-Instance-Id使用，填入的X-Instance-Id值需与Token生成时填入的值保持一致。

URI

GET /v1/iotfm/auth/tokens

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Instance-Id

是

String

参数说明：实例ID。通过访问智能设施云平台界面后获取，智能设施云平台资源均为实例级隔离，所有业务接口必须填写正确的实例ID才能被成功调用。

取值范围：长度8-36，只允许大小写字母、数字和-字符的组合。

X-Auth-Token

是

String

参数说明：待校验的token。

取值范围：长度为1-32768的字符串。

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

token

InstanceToken object

参数说明：Token结构体。

取值范围：长度1-64。
表3 InstanceToken

参数

参数类型

描述

issued_at

String

参数说明：token颁发时间，格式为yyyy-MM-dd'T'HH:mm:ss.SSS'Z'。

取值范围：长度1-64。

expires_at

String

参数说明：token过期时间，格式为yyyy-MM-dd'T'HH:mm:ss.SSS'Z'。

取值范围：长度1-64。

methods

Array of strings

参数说明：获取token的方式。

取值范围：长度固定为1。

roles

Array of Role objects

参数说明：角色列表。

取值范围：长度1-32。

user

InstanceUserRsp object

用户
表4 Role

参数

参数类型

描述

id

String

参数说明：权限ID。默认显示为0，非真实权限ID。

取值范围：长度1-64。

name

String

参数说明：权限名称。

取值范围：长度1-64。
表5 InstanceUserRsp

参数

参数类型

描述

id

String

参数说明：用户ID。

取值范围：长度1-64。

name

String

参数说明：用户名。

取值范围：长度1-64。

password_expires_at

String

参数说明：密码过期时间（UTC时间），“”表示密码不过期，格式为yyyy-MM-dd'T'HH:mm:ss.SSS'Z'。

取值范围：长度1-64。

请求示例

校验Token

GET https://{endpoint}/v1/iotfm/auth/tokens

响应示例

状态码：200

OK

{
  "token" : {
    "issued_at" : "2021-03-04T07:33:22.504Z",
    "expires_at" : "2021-03-05T07:33:22.504Z",
    "methods" : [ "password" ],
    "roles" : [ {
      "id" : "0",
      "name" : "te_admin"
    } ],
    "user" : {
      "id" : "43f76c518877464da16dc25a18cae71a",
      "name" : "example_user",
      "password_expires_at" : ""
    }
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error
父主题： Token管理

相关文档