ScoreBat
Kehittäjätyökalut

Virallinen jalkapallovideoiden API

Pika-aloitus

  1. Hae käyttöoikeustunnuksesi käyttöoikeusvälilehdeltä.
  2. Kutsu jotakin API-päätepistettä, esimerkiksi:
    GET
  3. Käsittele JSON-vastaus.
  4. Lisää sivullesi vastauksessa olevan videon embed-HTML, jotta videosoitin näytetään. Mobiilisovelluksessa voit näyttää videon webview-näkymässä poimimalla videon URL-osoitteen upotuskoodista.

Käyttöoikeustunnus

Video API:n käyttö edellyttää API-käyttöoikeustunnusta.

Jokaisen pyynnön URL-osoitteessa on oltava käyttöoikeustunnuksesi token-parametrina.

Saat käyttöoikeustunnuksesi käyttöoikeusvälilehdeltä.

Päätepisteet

Voit noutaa videoiden upotuskoodit JSON-muodossa seuraavista päätepisteistä:

Free Feed

GET

Free Feed -päätepiste tarjoaa rajatun valikoiman ottelukoosteita. Se sisältää valikoituja liigoja ja vanhempia otteluita ja antaa esimakua koko Video API:n tarjonnasta.

  • Sisältää vain osan liigoista ja otteluista, usein vanhempia otteluita tai valikoituja koosteita.
  • Palauttaa virallisia, upotettavia videoita varmennetuista lähteistä.
  • Sopii hyvin testaamiseen.
  • Ei sisällä kaikkia maksullisten pakettien kilpailuja tai reaaliaikaisia päivityksiä.

Featured Feed

GET

Palauttaa kuratoidun ja ajankohtaisen syötteen, jossa on sekä tuoreita että merkittäviä otteluita jalkapallon suurimmista liigoista ja kilpailuista. Syöte nostaa esiin suosituimmat ja kiinnostavimmat ottelut, mutta ei sisällä jokaista ottelua. Jos haluat käyttää kaikkia tietyn liigan tai joukkueen videoita, käytä kilpailu- tai joukkuepäätepistettä.

  • Sisältää valikoiman tuoreita otteluita eri liigoista.
  • Ei sisällä kaikkia otteluita tai kilpailuja, vaan ainoastaan olennaisimmat.
  • Saatavilla kaikissa maksullisissa paketeissa.

Kilpailu

GET

Voit hakea minkä tahansa kilpailun videoita Kilpailu-päätepisteellä. Päätepiste palauttaa määritetyn kilpailun uusimpien otteluiden videot.

Esimerkiksi alla oleva URL-osoite palauttaa Premier League -kilpailun uusimpien otteluiden videot. Merkkijono england-premier-league on Premier League -kilpailun yksilöllinen tunniste (ID).

Tässä ovat joidenkin suosituimpien kilpailujen tunnisteet:

Premier League
Serie A
La Liga
Bundesliga
Ligue 1

Kaikkien kilpailujen tunnisteiden luettelo löytyy täältä.

Joukkue

GET

Voit hakea minkä tahansa joukkueen videoita Joukkue-päätepisteellä. Päätepiste palauttaa määritetyn joukkueen uusimpien otteluiden videot.

Esimerkiksi alla oleva URL-osoite palauttaa uusimpien otteluiden videot joukkueelle Real Madrid. Merkkijono real-madrid on joukkueen Real Madrid yksilöllinen tunniste (ID).

Tässä ovat joidenkin suosituimpien joukkueiden tunnisteet:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

Kaikkien joukkueiden tunnisteiden luettelo löytyy täältä.

Suorat lähetykset

GET

Palauttaa vain ottelut, joihin on saatavilla virallinen suora lähetys. Mukana ovat sekä käynnissä olevat että jo päättyneet ottelut. Kohteet tulevat näkyviin noin 5 minuuttia ennen aloituspotkua.

  • Näyttää vain ottelut, joihin on saatavilla virallinen, upotettava lähetys.
  • Sisältää käynnissä olevat ja hiljattain päättyneet ottelut sekä saatavilla olevat lähetysten tallenteet.
  • Kohteet alkavat näkyä noin 5 minuuttia ennen ilmoitettua aloituspotkua.

Päivitetyt päätepisteet

GET

Tämän päätepisteen avulla näet, mitkä kilpailu- tai joukkuesyötteet on päivitetty hiljattain. Näin jokaista päätepistettä ei tarvitse tarkistaa erikseen.

Vastauksen rakenne

Vastaus on JSON-objekti, jonka response-avain sisältää taulukon otteluobjekteja. Jokainen ottelu sisältää perustiedot, siihen liittyvän kilpailun tiedot ja luettelon saatavilla olevista videoista.

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-avain sisältää taulukon otteluobjekteja. Jokainen objekti vastaa yhtä jalkapallo-ottelua ja sisältää seuraavat kentät:

  • title – Ottelun nimi (esim. Chelsea - Manchester United).
  • competition – Kilpailun nimi (esim. England Premier League).
  • date – Ottelun aloituspäivä ja -aika.
  • thumbnail – Ottelun pikkukuvan URL-osoite.
  • videos – Taulukko kaikista otteluun saatavilla olevista videoista. Jokainen video-objekti sisältää seuraavat tiedot:
    • title – Videon nimi (esim. Highlights tai Extended Highlights).
    • embed – Videon HTML-upotuskoodi.
    • id – Videon yksilöllinen tunniste.
  • homeTeam / awayTeam – Otteluun osallistuvia joukkueita kuvaavat objektit, jotka sisältävät seuraavat tiedot:
    • name – Joukkueen koko nimi (esim. Chelsea).
    • slug – URL-osoitteissa käytettävä joukkueen polkutunnus (esim. chelsea).
    • id – Joukkueen yksilöllinen tunniste.
  • matchviewUrl – Ottelunäkymäwidgetin URL-osoite. Sivu sisältää tarkkoja tietoja, kuten reaaliaikaiset tulokset, tilastot ja sarjataulukot.
  • competitionUrl – Kilpailuwidgetin URL-osoite. Widget näyttää reaaliaikaiset sarjataulukot, tulokset ja tulevat ottelut.

Automaattinen toisto

Voit ottaa automaattisen toiston käyttöön lisäämällä videon URL-osoitteeseen parametrin autoplay=1.

Esimerkki:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Jos käytät embed-HTML:ää suoraan, voit lisätä &autoplay=1 videon URL-osoitteeseen iframe-elementin src-määritteessä.

Käyttöraja

Jokaiseen pakettiin sisältyy kuukausittainen pyyntöraja.

  • Jokainen videon katselukerta tai widgetin näyttökerta lasketaan 1 pyynnöksi.
  • Jokainen Video API -kutsu kuluttaa kuukausikiintiöstä 5 pyyntöä.

Esimerkiksi:

  • Starter-paketti sisältää 5 000 pyyntöä kuukaudessa.
  • Standard-paketti sisältää 20 000 pyyntöä kuukaudessa.
  • Advanced-paketti sisältää 100 000 pyyntöä kuukaudessa.
  • Jos tarvitset suuremman rajan, ota meihin yhteyttä ja kysy Enterprise-paketeistamme.

Jos kuukausittainen pyyntöraja ylittyy, tili siirtyy automaattisesti ilmaispakettiin seuraavan laskutuskauden alkuun asti. Tänä aikana widgeteissä ja videoissa näytetään mainoksia ja ScoreBat-logoja, ja käytettävissä on vain Free Feed -päätepiste.