본문으로 건너뛰기
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 레퍼런스