获取令牌

更新时间:2024-05-28 07:29:48下载pdf

本文介绍获取令牌的 API。

接口描述

针对云云对接场景,开发者可以从平台申请云 API 授权,采用简单模式,隐式获取令牌。

前提条件

开始调用接口之前,请仔细阅读以下文档。

快速入门

调用接口实践

接口地址

GET: /v1.0/token

请求参数

参数名 类型 参数位置 是否必填 说明
req TokenReq query true API 请求

req 说明

参数名 类型 参数位置 是否必填 说明
grant_type String true 授权类型。
  • 1:简单模式。
  • 2:OAuth 2.0 授权模式。
code String false 授权码 Code。仅 grant_type 取值为 2 时,支持本参数。
terminal_id String false 端 ID。
target_uid String false IAM 鉴权用户唯一标识。仅 grant_type 取值为 1 时,支持接入资源授权服务(IAM)。

返回参数

参数名 类型 说明
result TokenRes 响应结果。

result 说明

参数名 类型 说明
access_token String 访问令牌。
expire_time Integer 有效时间,单位:秒。
refresh_token String 刷新令牌。
uid String 涂鸦用户 ID。

请求示例

GET: /v1.0/token?grant_type=1

返回示例

{
    "expire_time": 7200,
    "access_token": "**",
    "uid": "eu*****",
    "refresh_token": "**"
}

错误码

参考 错误码