文档首页/ 组织成员账号 OrgID/ API参考/ API/ 基于OAuth的应用认证集成/ 获取AccessToken
更新时间：2024-02-29 GMT+08:00
查看PDF
分享

获取AccessToken

功能介绍

获取Access Token，Access Token可用于调用获取用户信息API。

URI

POST /orgid/openapi/v1/oauth2/token

请求参数

表1 FormData参数

参数

是否必选

参数类型

描述

grant_type

是

String

授权方式，该参数为固定值authorization_code。

code

是

String

授权码，基于OAuth协议，OrgID给用户颁发的code。

client_id

是

String

应用标识，创建应用后OrgID提供的client_id。

client_secret

是

String

应用密钥，创建应用后OrgID提供的client_secret。

redirect_uri

是

String

回调地址，即code的接收地址，与创建自建应用时配置的首页URL一致。

access_type

否

String

接入模式，默认为在线模式，可不填，如需设置为离线模式，可设置为“offline”，设置后会返回refresh_token。

响应参数

状态码： 200

表2 响应Body参数

参数

参数类型

描述

access_token

String

用户级token，授权服务器返回给第三方应用的访问令牌。

refresh_token

String

用户级刷新token，离线模式适用，用于客户端主动刷新用户token。

scope

String

授权信息范围。

token_type

String

访问令牌类型。固定值“Bearer”，消息头传入token时前缀填入方式。

expires_in

Long

访问令牌的有效期，以秒为单位。

状态码： 400

表3 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

error

String

错误码（兼容原开放接口字段）。

error_description

String

错误描述（兼容原开放接口字段）。

状态码： 401

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

error

String

错误码（兼容原开放接口字段）。

error_description

String

错误描述（兼容原开放接口字段）。

状态码： 500

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

error

String

错误码（兼容原开放接口字段）。

error_description

String

错误描述（兼容原开放接口字段）。

请求示例

POST https://orgid.huaweiapaas.cn/orgid/openapi/v1/oauth2/token 
Content-Type: application/x-www-form-urlencoded

{ 
  grant_type: authorization_code
  client_id: 85d6fafdb128582dfaa312f25a9630fd0f32
  client_secret: 11edba361e6a0965206f14304
  redirect_uri: http=//123456789.com
  code:-hp8fzV3Bzk*********************kO_g7ZjbGftCHuR
}

响应示例

状态码： 200

正常响应。

{
    "access_token": "SetPuNNPf49RlT16Y0fvmqetHYmndhXLI7e8lq-4zOJAsKfPmD",
    "refresh_token": "PMBlkkSHDqFtxyNSQrHJfyxdJyNoqiq2_EdhMqRrlQKcbObFeWD",
    "scope": "phone profile email",
    "token_type": "Bearer",
    "expires_in": 7200
}

状态码

状态码

描述

200

正常响应。

400

参数错误响应。

401

权限错误响应。

500

系统错误响应。

错误码

请参见错误码。

相关文档