Перейти до вмісту
Sursa Developers

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

Отримати метадані сервера авторизації

get_oauth_server_metadata

Метадані сервера авторизації OAuth 2.0 (RFC 8414): issuer — основна адреса інсталяції, сторінка згоди розташована на основній адресі, а кінцеві точки видачі та відкликання токенів — на адресі API, якщо її задано. Перелічує підтримувані типи надання (grant types), методи 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