Μετάβαση στο περιεχόμενο
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