Zum Inhalt springen
Sursa Developers

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

Metadaten des Autorisierungsservers abrufen

get_oauth_server_metadata

Metadaten des OAuth-2.0-Autorisierungsservers (RFC 8414): issuer ist die Hauptadresse der Installation, die Zustimmungsseite liegt auf der Hauptadresse, und die Endpunkte für Token und Widerruf liegen auf der API-Adresse, sofern eine festgelegt ist. Listet die unterstützten Grant-Typen, PKCE-Methoden, Methoden der Client-Authentifizierung und Scopes auf. Hinzugefügt in 1.62.0.

Authentifizierung

Keine Anmeldedaten erforderlich.

Antworten

200Erfolgreiche Antwort

Antwort-Header

  • RateLimit-Policy

    Geltende Limits im Format des IETF-Entwurfs draft-ietf-httpapi-ratelimit-headers: durch Kommas getrennte Einträge "<name>";q=<quota>;w=<window in seconds>. key ist die Anfragerate des API-Schlüssels (das Kontingent ist der Burst, das Fenster die Zeit bis zum vollständigen Auffüllen; für eine Sitzung heißt der Eintrag user, ohne Anmeldedaten ip); minute, day und month sind die Kontingente der Organisation für die Kalenderminute, den Kalendertag und den Kalendermonat in UTC.

  • RateLimit

    Was von jedem Limit in RateLimit-Policy übrig ist: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Limit des strengsten Eintrags in RateLimit-Policy (des Eintrags mit den wenigsten verbleibenden Anfragen).

  • X-RateLimit-Remaining

    Verbleibende Anfragen unter dem strengsten Limit.

  • X-RateLimit-Reset

    Sekunden bis zum Zurücksetzen des strengsten Limits.

application/json

Objekt: OAuthServerMetadata

  • issuerstringerforderlich
  • authorization_endpointstringerforderlich
  • token_endpointstringerforderlich
  • revocation_endpointstringerforderlich
  • response_types_supportedarray of stringerforderlich
  • grant_types_supportedarray of stringerforderlich
  • code_challenge_methods_supportedarray of stringerforderlich
  • token_endpoint_auth_methods_supportedarray of stringerforderlich
  • revocation_endpoint_auth_methods_supportedarray of stringerforderlich
  • scopes_supportedarray of stringerforderlich
  • service_documentationstring

Ratenlimits

Antworten enthalten die Header RateLimit und RateLimit-Policy sowie die älteren X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset. Eine Antwort 429 enthält Retry-After in Sekunden: Warten Sie und versuchen Sie es dann erneut.

← oauth · API-Referenz