ScoreBat
כלים למפתחים

API רשמי לסרטוני כדורגל

התחלה מהירה

  1. קבלו את אסימון הגישה שלכם מ־לשונית הגישה.
  2. בצעו קריאה לאחת מנקודות הקצה של ה־API, לדוגמה:
    GET
  3. נתחו את תגובת ה־JSON.
  4. כדי להציג את הנגן, הוסיפו לדף שלכם את קוד ה־HTML שבשדה embed של אחד הסרטונים בתגובה. באפליקציות לנייד אפשר להציג את הסרטון ב־webview באמצעות חילוץ כתובת הווידאו מקוד ההטמעה.

אסימון גישה

כדי להשתמש ב־Video API נדרש אסימון גישה ל־API.

כל בקשה חייבת לכלול את אסימון הגישה שלכם בפרמטר token שבכתובת ה־URL של הבקשה.

אפשר לקבל את אסימון הגישה ב־לשונית הגישה.

נקודות קצה

אפשר לקבל את קודי ההטמעה של הסרטונים בפורמט JSON מנקודות הקצה הבאות:

Free Feed

GET

נקודת הקצה Free Feed מעניקה גישה למבחר מוגבל של תקצירי משחקים. היא כוללת ליגות נבחרות ומשחקים ישנים יותר ומאפשרת להתרשם מגרסת Video API המלאה.

  • כוללת רק חלק מהליגות והמשחקים, ולעיתים קרובות מציגה משחקים ישנים יותר או תקצירים נבחרים.
  • מחזירה סרטונים רשמיים ממקורות מאומתים שניתנים להטמעה.
  • מתאימה במיוחד לבדיקות.
  • אינה כוללת את כל התחרויות או העדכונים החיים הזמינים בחבילות בתשלום.

Featured Feed

GET

מחזירה פיד נבחר ורלוונטי הכולל משחקים עדכניים וחשובים מהליגות ומתחרויות הכדורגל המובילות. הפיד מדגיש את המשחקים הפופולריים והבולטים ביותר, אך אינו כולל כל משחק. כדי לגשת לכל הסרטונים של ליגה או קבוצה מסוימת, השתמשו בנקודות הקצה של תחרויות או קבוצות.

  • כוללת מבחר משחקים מהתקופה האחרונה ממגוון ליגות.
  • אינה כוללת את כל המשחקים או התחרויות — רק את הרלוונטיים ביותר.
  • זמינה בכל החבילות בתשלום.

תחרות

GET

אפשר לקבל סרטונים של כל תחרות באמצעות נקודת הקצה תחרות. נקודת קצה זו מחזירה סרטונים מהמשחקים האחרונים של התחרות שצוינה.

לדוגמה, כתובת ה־URL שלמטה מחזירה סרטונים מהמשחקים האחרונים של Premier League. המחרוזת england-premier-league היא המזהה הייחודי (ID) של Premier League.

אלה המזהים של כמה מהתחרויות הפופולריות ביותר:

פרמייר ליג
סרייה א'
לה ליגה
בונדסליגה
ליג 1

אפשר למצוא את רשימת המזהים של כל התחרויות כאן.

קבוצה

GET

אפשר לקבל סרטונים של כל קבוצה באמצעות נקודת הקצה קבוצה. נקודת קצה זו מחזירה סרטונים מהמשחקים האחרונים של הקבוצה שצוינה.

לדוגמה, כתובת ה־URL שלמטה מחזירה סרטונים מהמשחקים האחרונים של Real Madrid. המחרוזת real-madrid היא המזהה הייחודי (ID) של Real Madrid.

אלה המזהים של כמה מהקבוצות הפופולריות ביותר:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

אפשר למצוא את רשימת המזהים של כל הקבוצות כאן.

שידורים חיים

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 – מזהה ה־slug של הקבוצה המשמש בכתובות URL (לדוגמה, chelsea).
    • id – המזהה הייחודי של הקבוצה.
  • matchviewUrl – כתובת ה־URL של דף ווידג'ט המשחק, הכולל מידע מפורט כגון תוצאות בזמן אמת, סטטיסטיקות וטבלאות.
  • competitionUrl – כתובת ה־URL של ווידג'ט התחרות, המציג טבלאות עדכניות, תוצאות ומשחקים קרובים.

הפעלה אוטומטית

אפשר להפעיל ניגון אוטומטי באמצעות הוספת הפרמטר autoplay=1 לכתובת הווידאו.

לדוגמה:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1אם אתם משתמשים ישירות בקוד ה־HTML שבשדה embed, אפשר להוסיף &autoplay=1 לכתובת הווידאו בתוך src של ה־iframe.

מכסה

כל חבילה כוללת מגבלת בקשות חודשית.

  • כל צפייה בסרטון או הצגה של ווידג'ט נספרת כ־בקשה אחת.
  • כל קריאה ל־Video API נספרת כ־5 בקשות מתוך המכסה החודשית.

לדוגמה:

  • חבילת Starter כוללת 5,000 בקשות בחודש.
  • חבילת Standard כוללת 20,000 בקשות בחודש.
  • חבילת Advanced כוללת 100,000 בקשות בחודש.
  • אם דרושה לכם מגבלה גבוהה יותר, צרו איתנו קשר לקבלת פרטים על חבילות Enterprise.

אם תחרגו ממגבלת הבקשות החודשית, החשבון יעבור אוטומטית ל־חבילה החינמית עד לתקופת החיוב הבאה. במהלך הזמן הזה יופיעו פרסומות וסמלי ScoreBat בווידג'טים ובסרטונים, ורק נקודת הקצה Free Feed תישאר נגישה.