Vai al contenuto
Sursa Developers

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

Ottenere i metadati del server di autorizzazione

get_oauth_server_metadata

Metadati del server di autorizzazione OAuth 2.0 (RFC 8414): issuer è l’indirizzo principale dell’installazione, la pagina di consenso si trova sull’indirizzo principale, e l’endpoint del token e l’endpoint di revoca si trovano sull’indirizzo dell’API, se è impostato. Elenca i tipi di concessione supportati, i metodi PKCE, i metodi di autenticazione del client e gli ambiti. Aggiunto nella 1.62.0.

Autenticazione

Non servono credenziali.

Risposte

200Risposta riuscita

Intestazioni della risposta

  • RateLimit-Policy

    Limiti in vigore, nel formato della bozza IETF draft-ietf-httpapi-ratelimit-headers: elementi separati da virgole "<name>";q=<quota>;w=<window in seconds>. key è la frequenza delle richieste della chiave API (la quota è il burst, la finestra è il tempo necessario a ricaricarla completamente; per una sessione è user, senza credenziali ip); minute, day e month sono le quote dell’organizzazione per il minuto, il giorno e il mese di calendario in UTC.

  • RateLimit

    Quanto resta di ciascun limite di RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Limite della voce più restrittiva di RateLimit-Policy (quella con meno richieste rimanenti).

  • X-RateLimit-Remaining

    Richieste rimanenti nel limite più restrittivo.

  • X-RateLimit-Reset

    Secondi che mancano all’azzeramento del limite più restrittivo.

application/json

Oggetto: OAuthServerMetadata

  • issuerstringobbligatorio
  • authorization_endpointstringobbligatorio
  • token_endpointstringobbligatorio
  • revocation_endpointstringobbligatorio
  • response_types_supportedarray of stringobbligatorio
  • grant_types_supportedarray of stringobbligatorio
  • code_challenge_methods_supportedarray of stringobbligatorio
  • token_endpoint_auth_methods_supportedarray of stringobbligatorio
  • revocation_endpoint_auth_methods_supportedarray of stringobbligatorio
  • scopes_supportedarray of stringobbligatorio
  • service_documentationstring

Limiti di frequenza

Le risposte contengono le intestazioni RateLimit e RateLimit-Policy e le precedenti X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset. Una risposta 429 contiene Retry-After in secondi: attendi e riprova.

← oauth · Riferimento API