← العودة إلى المساعدة

الواجهة البرمجية العامة

وصول للقراءة فقط إلى بيانات المسابقات العامة. لا تتطلب مصادقة.

ملاحظات

  • الاستجابات مخزّنة مؤقتًا لمدة 60 ثانية (stale-while-revalidate).
  • CORS مفتوح: Access-Control-Allow-Origin: * على جميع مسارات /api/v0/*.
  • هذه v0 — قد تتغير الواجهة البرمجية مع تطور المنصة.
  • تنطبق حدود المعدل؛ الاستخدام المعقول مقبول دائمًا.
GET /api/v0/events

يُعيد جميع المسابقات العامة عبر كل المؤسسات.

الحقول: league_id, event_id, league_name, event_name, competition_type, format, status, starts_at, ends_at, venue_city, champion_name.

مثال

https://league.asabya.com/api/v0/events
GET /api/v0/events/[eventId]/standings

يُعيد جدول الترتيب لمسابقة واحدة.

الحقول: rank, club_name, played, won, drawn, lost, goals_for, goals_against, points.

مثال

https://league.asabya.com/api/v0/events/YOUR_EVENT_ID/standings
GET /api/v0/events/[eventId]/bracket

يُعيد بيانات فتحات القوس لمسابقات خروج المغلوب.

الحقول: match_id, round_ordinal, side, team_id, bracket_role, source_match_id, source_outcome, status, winner_team_id.

مثال

https://league.asabya.com/api/v0/events/YOUR_EVENT_ID/bracket
GET /rest/v1/league_feed

يُعيد أحداث تيار النشاط لدوري عام — النتائج وتغيرات الترتيب والإعلانات بترتيب زمني. يتطلب مفتاح anon كـ Authorization header.

الحقول: id, league_id, division_id, type (result | rank_change | announcement), payload (JSON), created_at. الفلتر: ?league_id=eq.[id]&order=created_at.desc&limit=20

مثال

https://<project>.supabase.co/rest/v1/league_feed?league_id=eq.YOUR_LEAGUE_ID&order=created_at.desc&limit=20
GET /rest/v1/match_reactions

يُعيد التفاعلات على مباريات الدوريات العامة. كل صف يمثل تفاعلًا واحدًا من زائر مُسمّى.

الحقول: match_id, emoji, display_name, created_at. الفلتر: ?match_id=eq.[id]

مثال

https://<project>.supabase.co/rest/v1/match_reactions?match_id=eq.YOUR_MATCH_ID
GET /rest/v1/match_comments

يُعيد التعليقات الموافق عليها لمباريات الدوريات العامة. يُعيد التعليقات الموافق عليها فقط.

الحقول: id, match_id, display_name, body, created_at. الفلتر: ?match_id=eq.[id]&order=created_at.asc

مثال

https://<project>.supabase.co/rest/v1/match_comments?match_id=eq.YOUR_MATCH_ID&order=created_at.asc
GET /rest/v1/announcements

يُعيد الإعلانات المنشورة للدوريات العامة.

الحقول: id, league_id, division_id, club_id, title, body, published_at. الفلتر: ?league_id=eq.[id]&order=published_at.desc

مثال

https://<project>.supabase.co/rest/v1/announcements?league_id=eq.YOUR_LEAGUE_ID&order=published_at.desc

نقاط نهاية /rest/v1/ أعلاه تستخدم واجهة Supabase REST مباشرة. أضف apikey header مع مفتاح anon لمشروعك.