获取令牌

更新时间:2025-03-06 02:04:21下载pdf

本文介绍获取令牌的 API。

接口描述

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

前提条件

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

接口地址

GET: /v1.0/token

请求参数

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

req 说明

参数名 类型 参数位置 是否必填 说明
grant_type String query true 授权类型
  • 1:简单模式
  • 2:OAuth 2.0 授权模式
code String query false 授权码 Code,仅 grant_type 取值为 2 时,支持本参数
terminal_id String query false 端 ID
target_uid String query 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": "**"
}

错误码

参考 错误码