文档首页/ 智能体身份/ API参考/ API/ OAuth2.0流程/ OAuth 2.0 推送授权请求(PAR)标准的授权 API
更新时间:2026-11-04 GMT+08:00
分享

OAuth 2.0 推送授权请求(PAR)标准的授权 API

功能介绍

遵循RFC 9126 PAR规范的核心OAuth2授权端点,仅通过request_uri参数接受授权请求以触发用户授权流程。

URI

GET /v1/oauth2/authorize

表1 Query参数

参数

是否必选

参数类型

描述

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流程服务临时问题,无法处理授权请求

错误码

请参见错误码。

相关文档