Aller au contenu
Sursa Developers

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

Obtenir les métadonnées du serveur d’autorisation

get_oauth_server_metadata

Métadonnées du serveur d’autorisation OAuth 2.0 (RFC 8414) : issuer est l’adresse principale de l’installation, la page de consentement se trouve sur l’adresse principale, et les points de terminaison de jetons et de révocation sont sur l’adresse de l’API lorsqu’elle est définie. Liste les types d’octroi (grant types), les méthodes PKCE, les méthodes d’authentification des clients et les portées pris en charge. Ajouté dans la version 1.62.0.

Authentification

Aucun identifiant nécessaire.

Réponses

200Réponse réussie

En-têtes de la réponse

  • RateLimit-Policy

    Limites en vigueur, au format du brouillon IETF draft-ietf-httpapi-ratelimit-headers : éléments séparés par des virgules "<name>";q=<quota>;w=<window in seconds>. key est le débit de requêtes de la clé API (le quota est la rafale, la fenêtre est le temps nécessaire pour la reconstituer entièrement ; pour une session, c’est user, sans identifiants, ip) ; minute, day et month sont les quotas de l’organisation pour la minute, le jour et le mois calendaires en UTC.

  • RateLimit

    Ce qui reste de chaque limite de RateLimit-Policy : "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Limite de l’entrée la plus stricte de RateLimit-Policy (celle à laquelle il reste le moins de requêtes).

  • X-RateLimit-Remaining

    Requêtes restantes au titre de la limite la plus stricte.

  • X-RateLimit-Reset

    Secondes restantes avant la réinitialisation de la limite la plus stricte.

application/json

Objet : OAuthServerMetadata

  • issuerstringobligatoire
  • authorization_endpointstringobligatoire
  • token_endpointstringobligatoire
  • revocation_endpointstringobligatoire
  • response_types_supportedarray of stringobligatoire
  • grant_types_supportedarray of stringobligatoire
  • code_challenge_methods_supportedarray of stringobligatoire
  • token_endpoint_auth_methods_supportedarray of stringobligatoire
  • revocation_endpoint_auth_methods_supportedarray of stringobligatoire
  • scopes_supportedarray of stringobligatoire
  • service_documentationstring

Limites de débit

Les réponses portent les en-têtes RateLimit et RateLimit-Policy, ainsi que les anciens X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset. Une réponse 429 contient Retry-After en secondes : attendez, puis réessayez.

← oauth · Référence de l’API