Pular para o conteúdo
Sursa Developers

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

Obter os metadados do servidor de autorização

get_oauth_server_metadata

Metadados do servidor de autorização OAuth 2.0 (RFC 8414): issuer é o endereço principal da instalação, a página de consentimento fica no endereço principal, e os endpoints de token e de revogação ficam no endereço da API, quando ele está definido. Lista os tipos de concessão, os métodos PKCE, os métodos de autenticação de cliente e os escopos suportados. Adicionado na versão 1.62.0.

Autenticação

Não são necessárias credenciais.

Respostas

200Resposta bem-sucedida

Cabeçalhos da resposta

  • RateLimit-Policy

    Limites em vigor, no formato do rascunho da IETF draft-ietf-httpapi-ratelimit-headers: itens separados por vírgula "<name>";q=<quota>;w=<window in seconds>. key é a taxa de requisições da chave de API (a cota é a rajada, a janela é o tempo para reabastecê-la por completo; para uma sessão é user, sem credenciais é ip); minute, day e month são as cotas da organização para o minuto, o dia e o mês do calendário em UTC.

  • RateLimit

    O que resta de cada limite de RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Limite da entrada mais restritiva de RateLimit-Policy (a que tem menos requisições restantes).

  • X-RateLimit-Remaining

    Requisições restantes no limite mais restritivo.

  • X-RateLimit-Reset

    Segundos até o limite mais restritivo ser reiniciado.

application/json

Objeto: OAuthServerMetadata

  • issuerstringobrigatório
  • authorization_endpointstringobrigatório
  • token_endpointstringobrigatório
  • revocation_endpointstringobrigatório
  • response_types_supportedarray of stringobrigatório
  • grant_types_supportedarray of stringobrigatório
  • code_challenge_methods_supportedarray of stringobrigatório
  • token_endpoint_auth_methods_supportedarray of stringobrigatório
  • revocation_endpoint_auth_methods_supportedarray of stringobrigatório
  • scopes_supportedarray of stringobrigatório
  • service_documentationstring

Limites de taxa

As respostas trazem os cabeçalhos RateLimit e RateLimit-Policy e os anteriores X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset. Uma resposta 429 traz Retry-After em segundos: aguarde e tente de novo.

← oauth · Referência da API