GET /oauth/authorize

OAuth 2.0 授权端点。提供 redirect_uri 时返回 302 重定向；未提供时返回 JSON 授权码。支持 PKCE 和 PAR（通过 request_uri）。参考：RFC 6749 §4.1.1-4.1.2.1 (Authorization Code Grant)、RFC 7636 (PKCE)、RFC 9126 (PAR)、OAuth 2.1 可选 iss 参数。

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
response_type	query	string	是				响应类型（仅支持 code）
client_id	query	string	是				客户端ID
redirect_uri	query	string	否				重定向URI
scope	query	string	否				请求的权限范围
state	query	string	否				防CSRF状态参数
iss	query	string	否				Issuer URL（OAuth 2.1）
nonce	query	string	否				OIDC nonce 参数
code_challenge	query	string	否				PKCE Code Challenge（RFC 7636）
code_challenge_method	query	string	否				PKCE 方法（S256）
authorization_details	query	string	否				Authorization Details（RFC 9396）
request_uri	query	string	否				PAR Request URI（RFC 9126）

响应

状态	描述	Schema
200	授权码（无 redirect_uri 时）	handler.authorizeCodeResponse
302	重定向到回调URL并附带 OAuth 错误（invalid_request/invalid_client/unsupported_response_type）	string
400	invalid_request_uri：PAR 请求无效/过期/已使用。参考：RFC 9126。	service-oauth/internal/handler/dto.OAuthErrorResponse
500	server_error：授权服务器内部错误。参考：RFC 6749 §5.2。	service-oauth/internal/handler/dto.OAuthErrorResponse

引用的 Schema

service-oauth/internal/handler/dto.OAuthErrorResponse

OAuth标准错误响应

字段	类型	必填	示例	约束	描述
error	string	否	invalid_request		错误码
error_description	string	否	Missing required parameter		错误描述
error_uri	string	否	https://docs.example.com/errors		错误URI
i18n_key	string	否	error.oauth_invalid_request		I18nKey 本地化键（AUTH-46①/U416）：协议字段 error/error_description 保持 RFC 6749 §5.2 原样， 本字段是**附加**信息（omitempty；未知错误码不填），供前端/AI 客户端按键确定性渲染文案， 无需解析英文原文。仅出现在 JSON 错误体，不写入 302 错误重定向的查询串。
state	string	否	state-123		状态

handler.authorizeCodeResponse

字段	类型	必填	示例	约束	描述
code	string	否
state	string	否