Ir al contenido
Sursa Developers

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

Obtener los metadatos del servidor de autorización

get_oauth_server_metadata

Metadatos del servidor de autorización OAuth 2.0 (RFC 8414): issuer es la dirección principal de la instalación, la página de consentimiento está en la dirección principal y los endpoints de token y de revocación están en la dirección de la API, si se ha configurado una. Enumera los tipos de concesión, los métodos PKCE, los métodos de autenticación de clientes y los ámbitos admitidos. Se añadió en 1.62.0.

Autenticación

No se necesitan credenciales.

Respuestas

200Respuesta correcta

Encabezados de la respuesta

  • RateLimit-Policy

    Límites vigentes, en el formato del borrador del IETF draft-ietf-httpapi-ratelimit-headers: elementos separados por comas "<name>";q=<quota>;w=<window in seconds>. key es la frecuencia de solicitudes de la clave de API (la cuota es la ráfaga y la ventana es el tiempo que tarda en recargarse por completo; para una sesión es user y sin credenciales, ip); minute, day y month son las cuotas de la organización para el minuto, el día y el mes naturales en UTC.

  • RateLimit

    Lo que queda de cada límite de RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Límite de la entrada más estricta de RateLimit-Policy (la que tiene menos solicitudes restantes).

  • X-RateLimit-Remaining

    Solicitudes restantes del límite más estricto.

  • X-RateLimit-Reset

    Segundos hasta que se restablece el límite más estricto.

application/json

Objeto: OAuthServerMetadata

  • issuerstringobligatorio
  • authorization_endpointstringobligatorio
  • token_endpointstringobligatorio
  • revocation_endpointstringobligatorio
  • response_types_supportedarray of stringobligatorio
  • grant_types_supportedarray of stringobligatorio
  • code_challenge_methods_supportedarray of stringobligatorio
  • token_endpoint_auth_methods_supportedarray of stringobligatorio
  • revocation_endpoint_auth_methods_supportedarray of stringobligatorio
  • scopes_supportedarray of stringobligatorio
  • service_documentationstring

Límites de frecuencia

Las respuestas incluyen los encabezados RateLimit y RateLimit-Policy y los anteriores X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset. Una respuesta 429 lleva Retry-After en segundos: espere y vuelva a intentarlo.

← oauth · Referencia de la API