انتقل إلى المحتوى
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