# 获取AccessToken - ShowOauth2Token
#### 功能介绍
获取Access Token，Access Token可用于调用获取用户信息API。
#### URI
POST /orgid/openapi/v1/oauth2/token
#### 请求参数
表1FormData参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                            |
|:---|:---|:---|:---|
| 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 | 系统错误响应。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-orgid/ErrorCode.html)。