获取AccessToken - IssueOAuthAccessToken
功能介绍
获取Access Token，Access Token可用于调用获取用户信息API。
接口约束
null
URI
POST /api/v1/oauth2/token
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
code | 是 | String | 授权码，认证登录获取授权码接口返回的授权码。 |
client_id | 是 | String | 应用标识，注册应用后，分配的ClientId。 |
client_secret | 是 | String | 应用密钥，注册应用后，分配的ClientSecret。 |
grant_type | 是 | String | 授权类型，固定值：authorization_code。 |
redirect_uri | 否 | String | 回调地址，地址可以是注册应用时填写的回调地址，也可以是注册应用时填写的回调地址的域名。若传入，则需要与调用认证登录获取授权码接口的入参redirect_url保持一致。 |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
access_token | String | 授权服务器返回给第三方应用的访问令牌。 |
token_type | String | 访问令牌类型。固定值：Bearer。 |
expires_in | Long | 访问令牌的有效期，以秒为单位。 |
scope | String | 授权范围。 |
refresh_token | String | 刷新令牌。默认不生成refresh_token，如果需要，在应用的“认证配置”中设置“Refresh Token有效期”后生成返回。 |
状态码：400
参数 | 参数类型 | 描述 |
|---|---|---|
error | String | 错误类型。 |
error_description | String | 错误描述。 |
请求示例
获取AccessToken，后续使用该token获取用户信息。code使用认证登录获取授权码接口返回的授权码z2D...，client_id和client_secret使用注册应用时分配的ClientId和ClientSecret，redirect_uri配置为应用的回调地址https://example.com，grant_type为固定值authorization_code。
POST https://{domain_name}/api/v1/oauth2/token
Content-Type: application/x-www-form-urlencoded
code=z2D...&
client_id=NzZeWuiJa91dPSRdZQChMazIh13AW...&
client_secret=NzZeWuiJa91dPSRdZQChMazIh13AW...&
redirect_uri=https://example.com&
grant_type=authorization_code 响应示例
状态码：200
请求成功。
{
"access_token" : "NqM******d3k",
"token_type" : "Bearer",
"expires_in" : "7200",
"scope" : "get_user_info",
"refresh_token" : "42e******w24"
} 状态码：400
请求错误。
{
"error" : "invalid_grant",
"error_description" : "Invalid authorization code"
} 状态码
状态码 | 描述 |
|---|---|
200 | 请求成功。 |
400 | 请求错误。 |
错误码
请参见错误码。
