跳到主要内容
Sursa Developers

GET/.well-known/oauth-authorization-server

获取授权服务器元数据

get_oauth_server_metadata

OAuth 2.0 授权服务器元数据(RFC 8414):issuer 是部署的主地址,授权同意页面位于主地址,令牌端点和撤销端点在设置了 API 专用地址时位于该地址。列出支持的授权类型、PKCE 方法、客户端身份验证方法和权限范围。在 1.62.0 中新增。

身份验证

无需凭据。

响应

200成功响应

响应头

  • RateLimit-Policy

    当前生效的限制,格式遵循 IETF 草案 draft-ietf-httpapi-ratelimit-headers:以逗号分隔的项 "<name>";q=<quota>;w=<window in seconds>。key 是 API 密钥的请求速率(配额即突发量,时间窗口是配额完全恢复所需的时间;会话为 user,无凭据时为 ip);minute、day 和 month 是组织按 UTC 计算的自然分钟、自然日和自然月的配额。

  • RateLimit

    RateLimit-Policy 中每项限制的剩余量:"<name>";r=<remaining>;t=<seconds until reset>。

  • X-RateLimit-Limit

    RateLimit-Policy 中最严格一项(剩余请求数最少的一项)的限额。

  • X-RateLimit-Remaining

    最严格限制下的剩余请求数。

  • X-RateLimit-Reset

    距最严格限制重置的秒数。

application/json

对象:OAuthServerMetadata

  • issuerstring必填
  • authorization_endpointstring必填
  • token_endpointstring必填
  • revocation_endpointstring必填
  • response_types_supportedarray of string必填
  • grant_types_supportedarray of string必填
  • code_challenge_methods_supportedarray of string必填
  • token_endpoint_auth_methods_supportedarray of string必填
  • revocation_endpoint_auth_methods_supportedarray of string必填
  • scopes_supportedarray of string必填
  • service_documentationstring

速率限制

响应带有 RateLimit 和 RateLimit-Policy 头,以及旧版的 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset 头。429 响应带有以秒为单位的 Retry-After:等待后重试。

← oauth · API 参考