# OAuth 2.0 推送授权请求（PAR）标准的授权 API
#### 功能介绍
遵循RFC 9126 PAR规范的核心OAuth2授权端点，仅通过request_uri参数接受授权请求以触发用户授权流程。
#### URI
GET /v1/oauth2/authorize
表1Query参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| request_uri | 是    | String | **参数解释**： OAuth 2.0 PAR标准请求URI，引用OAuth2流程的授权参数。 **约束限制**： 不涉及。 **取值范围**： 必须以"urn:ietf:params:oauth:request_uri:"开头，后面跟随字母、数字、"."、"-"、"_"、"\~"组成的字符串，长度为1\~1024个字符。 **默认取值**： 不涉及。 |
   
#### 请求参数
无
#### 响应参数
**状态码：400**
表2响应Body参数 
| 参数                | 参数类型   | 描述                                                                                                                                                                                                                            |
|:---|:---|:---|
| error             | String | **参数解释**： OAuth 2.0标准错误码，例如access_denied、invalid_request、invalid_client、unauthorized_client。 **取值范围**： 长度为1\~128个字符。 |
| error_description | String | **参数解释**： 人类可读的错误描述，URL编码以安全传输。 **取值范围**： 长度为1\~2048个字符。                                                             |
   
**状态码：404**
表3响应Body参数 
| 参数                | 参数类型   | 描述                                                                                                                                                                                                                            |
|:---|:---|:---|
| error             | String | **参数解释**： OAuth 2.0标准错误码，例如access_denied、invalid_request、invalid_client、unauthorized_client。 **取值范围**： 长度为1\~128个字符。 |
| error_description | String | **参数解释**： 人类可读的错误描述，URL编码以安全传输。 **取值范围**： 长度为1\~2048个字符。                                                             |
   
**状态码：500**
表4响应Body参数 
| 参数                | 参数类型   | 描述                                                                                                                                                                                                                            |
|:---|:---|:---|
| error             | String | **参数解释**： OAuth 2.0标准错误码，例如access_denied、invalid_request、invalid_client、unauthorized_client。 **取值范围**： 长度为1\~128个字符。 |
| error_description | String | **参数解释**： 人类可读的错误描述，URL编码以安全传输。 **取值范围**： 长度为1\~2048个字符。                                                             |
   
#### 请求示例
无
#### 响应示例
无
#### 状态码
| 状态码 | 描述                                            |
|:---|:---|
| 302 | 授权流程发起成功 - 通过Location头重定向到用户同意页面              |
| 400 | OAuth2无效请求 - request_uri格式无效、授权请求已过期或参数格式错误   |
| 404 | OAuth2无效请求 - 提供的request_uri未找到授权请求（无匹配的PAR注册） |
| 500 | OAuth2服务器错误 - OAuth2流程服务临时问题，无法处理授权请求         |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-agentidentity/ErrorCode.html)。