ScoreBat
أدوات المطورين

واجهة API الرسمية لفيديوهات كرة القدم

البدء السريع

  1. احصل على رمز الوصول من تبويب الوصول.
  2. استدعِ إحدى نقاط وصول API، مثلًا:
    GET
  3. حلّل استجابة JSON.
  4. أدرج HTML الخاص بـ embed لأحد فيديوهات الاستجابة في صفحتك لعرض المشغّل. وفي تطبيقات الهاتف، يمكنك عرض الفيديو داخل webview باستخراج عنوان URL الخاص به من كود التضمين.

رمز الوصول

تحتاج إلى رمز وصول API لاستخدام واجهة API للفيديو.

يجب أن يتضمن كل طلب رمز الوصول الخاص بك كمعامل token في عنوان URL للطلب.

يمكنك الحصول على رمز الوصول من تبويب الوصول.

نقاط الوصول

يمكنك استرجاع أكواد تضمين الفيديوهات بتنسيق JSON من نقاط الوصول التالية:

Free Feed

GET

تتيح لك نقطة Free Feed الوصول إلى مجموعة محدودة من ملخصات المباريات. وتشمل دوريات مختارة ومباريات أقدم، لتقدم معاينة لواجهة API الكاملة للفيديو.

  • تشمل مجموعة فرعية فقط من الدوريات والمباريات، وغالبًا ما تعرض مباريات أقدم أو ملخصات مختارة.
  • تعرض فيديوهات رسمية قابلة للتضمين من مصادر موثقة.
  • مثالية للاختبار.
  • لا تشمل جميع البطولات أو التحديثات المباشرة المتاحة في الخطط المدفوعة.

Featured Feed

GET

تعرض خلاصة منتقاة وملائمة تشمل مباريات حديثة ومهمة من أبرز دوريات وبطولات كرة القدم. تسلط الخلاصة الضوء على أكثر المباريات شعبية وجديرة بالاهتمام، لكنها لا تشمل كل مباراة. للوصول إلى جميع فيديوهات دوري أو فريق محدد، استخدم نقاط وصول البطولات أو الفرق.

  • تشمل مجموعة من المباريات الحديثة من دوريات مختلفة.
  • لا تشمل جميع المباريات أو البطولات، بل الأكثر أهمية فقط.
  • متاحة في جميع الخطط المدفوعة.

البطولة

GET

يمكنك الاستعلام عن فيديوهات أي بطولة باستخدام نقطة البطولة. تعرض هذه النقطة فيديوهات أحدث مباريات البطولة المحددة.

على سبيل المثال، يعرض عنوان URL أدناه فيديوهات أحدث مباريات الدوري الإنجليزي الممتاز. والنص england-premier-league هو المعرّف الفريد (ID) للدوري الإنجليزي الممتاز.

إليك معرّفات بعض أشهر البطولات:

الدوري الإنجليزي الممتاز
الدوري الإيطالي
الدوري الإسباني
الدوري الألماني
الدوري الفرنسي

يمكنك العثور على قائمة معرّفات جميع البطولات هنا.

الفريق

GET

يمكنك الاستعلام عن فيديوهات أي فريق باستخدام نقطة الفريق. تعرض هذه النقطة فيديوهات أحدث مباريات الفريق المحدد.

على سبيل المثال، يعرض عنوان URL أدناه فيديوهات أحدث مباريات Real Madrid. والنص real-madrid هو المعرّف الفريد (ID) لـ Real Madrid.

إليك معرّفات بعض أشهر الفرق:

ريال مدريد
برشلونة
أرسنال
تشيلسي
ليفربول
مانشستر سيتي
مانشستر يونايتد

يمكنك العثور على قائمة معرّفات جميع الفرق هنا.

البث المباشر

GET

تعرض فقط المباريات التي يتوفر لها بث رسمي مباشر، بما فيها المباريات الجارية والمنتهية. تبدأ العناصر في الظهور قبل انطلاق المباراة بنحو 5 دقائق.

  • تعرض فقط المباريات ذات البث الرسمي القابل للتضمين.
  • تشمل المباريات المباشرة والمنتهية مؤخرًا، مع إعادات البث عند توفرها.
  • تبدأ العناصر في الظهور قبل موعد انطلاق المباراة بنحو 5 دقائق.

نقاط الوصول المحدّثة

GET

تتيح لك نقطة الوصول هذه معرفة خلاصات البطولات أو الفرق التي حُدّثت مؤخرًا، دون الحاجة إلى الاستعلام المتكرر عن كل نقطة وصول منفردة.

بنية الاستجابة

الاستجابة عبارة عن كائن JSON يحتوي على مفتاح response وقيمته مصفوفة من كائنات المباريات. تتضمن كل مباراة معلوماتها الأساسية وتفاصيل البطولة ذات الصلة وقائمة بالفيديوهات المتاحة.

JSON
{"response": [{"title": "Chelsea - Manchester United","competition": "ENGLAND: Premier League","matchviewUrl": "...","competitionUrl": "...","thumbnail": "...","date": "2029-05-18T15:00:00+0000","homeTeam": {"name": "Chelsea","slug": "chelsea","id": 229},"awayTeam": {"name": "Manchester United","slug": "manchester-united","id": 243},"videos": [{"title": "Highlights","embed": "..."},{"title": "Extended Highlights","embed": "..."}]},...]}

يحتوي مفتاح response على مصفوفة من كائنات المباريات. يمثل كل كائن مباراة كرة قدم ويتضمن الحقول التالية:

  • title – اسم المباراة، مثل Chelsea - Manchester United.
  • competition – اسم البطولة، مثل England Premier League.
  • date – تاريخ ووقت انطلاق المباراة.
  • thumbnail – عنوان URL لصورة المباراة المصغرة.
  • videos – مصفوفة بجميع الفيديوهات المتاحة للمباراة. يتضمن كل كائن فيديو ما يلي:
    • title – عنوان الفيديو، مثل Highlights أو Extended Highlights.
    • embed – كود HTML لتضمين الفيديو.
    • id – المعرّف الفريد للفيديو.
  • homeTeam / awayTeam – كائنات تمثل الفرق المشاركة في المباراة، وتتضمن:
    • name – الاسم الكامل للفريق، مثل Chelsea.
    • slug – المعرّف النصي للفريق المستخدم في عناوين URL، مثل chelsea.
    • id – المعرّف الفريد للفريق.
  • matchviewUrl – عنوان URL لصفحة أداة عرض المباراة، ويتضمن معلومات تفصيلية مثل النتائج المباشرة والإحصاءات والترتيب.
  • competitionUrl – عنوان URL لأداة البطولة، ويعرض جداول الترتيب المباشرة والنتائج والمباريات القادمة.

تشغيل تلقائي

يمكنك تفعيل التشغيل التلقائي بإضافة المعامل autoplay=1 إلى عنوان URL للفيديو.

على سبيل المثال:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1إذا كنت تستخدم HTML الخاص بـ embed مباشرة، فيمكنك إضافة &autoplay=1 إلى عنوان URL للفيديو داخل src الخاص بإطار iframe.

الحصة

تتضمن كل خطة حدًا شهريًا للطلبات.

  • تُحتسب كل مشاهدة فيديو أو عرض أداة ضمن طلب واحد.
  • يُحتسب كل استدعاء لـ واجهة API للفيديو ضمن 5 طلبات من حصتك الشهرية.

على سبيل المثال:

  • تشمل خطة Starter عدد 5,000 طلب شهريًا.
  • تشمل خطة Standard عدد 20,000 طلب شهريًا.
  • تشمل خطة Advanced عدد 100,000 طلب شهريًا.
  • إذا كنت تحتاج إلى حد أعلى، تواصل معنا لمعرفة خطط Enterprise.

إذا تجاوزت حد الطلبات الشهري، سيتحول حسابك تلقائيًا إلى الخطة المجانية حتى دورة الفوترة التالية. خلال هذه الفترة، ستظهر الإعلانات وشعارات ScoreBat على الأدوات والفيديوهات، ولن تبقى متاحة سوى نقطة Free Feed.