OAuth 2.0 推送授权请求(PAR)标准的授权 API
功能介绍
遵循RFC 9126 PAR规范的核心OAuth2授权端点,仅通过request_uri参数接受授权请求以触发用户授权流程。
URI
GET /v1/oauth2/authorize
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| request_uri | 是 | String | 参数解释: OAuth 2.0 PAR标准请求URI,引用OAuth2流程的授权参数。 约束限制: 不涉及。 取值范围: 必须以"urn:ietf:params:oauth:request_uri:"开头,后面跟随字母、数字、"."、"-"、"_"、"~"组成的字符串,长度为1~1024个字符。 默认取值: 不涉及。 |
请求参数
无
响应参数
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error | String | 参数解释: OAuth 2.0标准错误码,例如access_denied、invalid_request、invalid_client、unauthorized_client。 取值范围: 长度为1~128个字符。 |
| error_description | String | 参数解释: 人类可读的错误描述,URL编码以安全传输。 取值范围: 长度为1~2048个字符。 |
状态码:404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error | String | 参数解释: OAuth 2.0标准错误码,例如access_denied、invalid_request、invalid_client、unauthorized_client。 取值范围: 长度为1~128个字符。 |
| error_description | String | 参数解释: 人类可读的错误描述,URL编码以安全传输。 取值范围: 长度为1~2048个字符。 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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流程服务临时问题,无法处理授权请求 |
错误码
请参见错误码。