Chuyển tới nội dung
Sursa Developers

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

Lấy siêu dữ liệu của máy chủ ủy quyền

get_oauth_server_metadata

Siêu dữ liệu của máy chủ ủy quyền OAuth 2.0 (RFC 8414): issuer là địa chỉ chính của bản cài đặt, trang xin quyền nằm trên địa chỉ chính, còn endpoint cấp token và endpoint thu hồi nằm trên địa chỉ API khi địa chỉ này được đặt. Liệt kê các loại cấp quyền (grant type), phương thức PKCE, phương thức xác thực client và phạm vi quyền được hỗ trợ. Được thêm trong 1.62.0.

Xác thực

Không cần thông tin xác thực.

Phản hồi

200Phản hồi thành công

Header phản hồi

  • RateLimit-Policy

    Các giới hạn đang áp dụng, theo định dạng của bản dự thảo IETF draft-ietf-httpapi-ratelimit-headers: các mục phân tách bằng dấu phẩy "<name>";q=<quota>;w=<window in seconds>. key là tốc độ yêu cầu của khóa API (hạn mức là đợt tăng đột biến, khung thời gian là thời gian để hạn mức hồi lại hoàn toàn; với phiên là user, khi không có thông tin xác thực là ip); minute, day và month là hạn mức của tổ chức cho phút, ngày và tháng theo lịch, tính theo UTC.

  • RateLimit

    Phần còn lại của mỗi giới hạn trong RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Giới hạn của mục chặt nhất trong RateLimit-Policy (mục còn ít yêu cầu nhất).

  • X-RateLimit-Remaining

    Số yêu cầu còn lại theo giới hạn chặt nhất.

  • X-RateLimit-Reset

    Số giây cho đến khi giới hạn chặt nhất được đặt lại.

application/json

Đối tượng: OAuthServerMetadata

  • issuerstringbắt buộc
  • authorization_endpointstringbắt buộc
  • token_endpointstringbắt buộc
  • revocation_endpointstringbắt buộc
  • response_types_supportedarray of stringbắt buộc
  • grant_types_supportedarray of stringbắt buộc
  • code_challenge_methods_supportedarray of stringbắt buộc
  • token_endpoint_auth_methods_supportedarray of stringbắt buộc
  • revocation_endpoint_auth_methods_supportedarray of stringbắt buộc
  • scopes_supportedarray of stringbắt buộc
  • service_documentationstring

Giới hạn tốc độ

Phản hồi có các header RateLimit và RateLimit-Policy cùng các header cũ hơn X-RateLimit-Limit, X-RateLimit-Remaining và X-RateLimit-Reset. Phản hồi 429 có Retry-After tính bằng giây: hãy chờ rồi thử lại.

← oauth · Tài liệu tham chiếu API