ScoreBat
Alat Pembangun

API Video Bola Sepak Rasmi

Mula Pantas

  1. Dapatkan token akses anda daripada tab akses.
  2. Panggil salah satu titik akhir API, contohnya:
    GET
  3. Huraikan respons JSON.
  4. Masukkan HTML embed bagi salah satu video daripada respons ke dalam halaman anda untuk memaparkan pemain video. Bagi aplikasi mudah alih, anda boleh memaparkan video dalam webview dengan mengekstrak URL video daripada kod benam.

Token akses

Anda memerlukan token akses API untuk menggunakan API Video.

Setiap permintaan mesti menyertakan token akses anda sebagai parameter token dalam URL permintaan.

Anda boleh mendapatkan token akses anda dalam tab akses.

Titik Akhir

Anda boleh mendapatkan kod benam video dalam format JSON daripada titik akhir berikut:

Free Feed

GET

Titik akhir Free Feed memberikan anda akses kepada set sorotan perlawanan yang terhad. Ia merangkumi liga terpilih dan perlawanan lama sebagai pratonton kepada API Video penuh.

  • Hanya merangkumi sebahagian liga dan perlawanan, lazimnya perlawanan lama atau sorotan terpilih.
  • Mengembalikan video rasmi yang boleh dibenamkan daripada sumber yang disahkan.
  • Sesuai untuk ujian.
  • Tidak merangkumi semua pertandingan atau kemas kini langsung yang tersedia dalam pelan berbayar.

Featured Feed

GET

Mengembalikan suapan pilihan yang relevan, merangkumi perlawanan terkini dan penting daripada liga serta pertandingan bola sepak utama. Suapan ini menonjolkan perlawanan paling popular dan menarik, tetapi tidak merangkumi setiap perlawanan. Untuk mengakses semua video bagi liga atau pasukan tertentu, gunakan titik akhir pertandingan atau pasukan.

  • Merangkumi pilihan perlawanan terkini daripada pelbagai liga.
  • Tidak merangkumi semua perlawanan atau pertandingan — hanya yang paling relevan.
  • Tersedia dalam semua pelan berbayar.

Pertandingan

GET

Anda boleh mendapatkan video bagi mana-mana pertandingan menggunakan titik akhir Pertandingan. Titik akhir ini mengembalikan video daripada perlawanan terkini bagi pertandingan yang dinyatakan.

Contohnya, URL di bawah mengembalikan video daripada perlawanan terkini Premier League. Rentetan england-premier-league ialah pengecam unik (ID) Premier League.

Berikut ialah ID bagi beberapa pertandingan paling popular:

Premier League
Serie A
La Liga
Bundesliga
Ligue 1

Anda boleh menemukan senarai ID semua pertandingan di sini.

Pasukan

GET

Anda boleh mendapatkan video bagi mana-mana pasukan menggunakan titik akhir Pasukan. Titik akhir ini mengembalikan video daripada perlawanan terkini pasukan yang dinyatakan.

Contohnya, URL di bawah mengembalikan video daripada perlawanan terkini Real Madrid. Rentetan real-madrid ialah pengecam unik (ID) Real Madrid.

Berikut ialah ID bagi beberapa pasukan paling popular:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

Anda boleh menemukan senarai ID semua pasukan di sini.

Siaran Langsung

GET

Hanya mengembalikan perlawanan yang mempunyai siaran langsung rasmi — termasuk perlawanan yang sedang berlangsung dan yang telah tamat. Entri mula dipaparkan kira-kira 5 minit sebelum sepak mula.

  • Hanya memaparkan perlawanan dengan siaran rasmi yang boleh dibenamkan.
  • Merangkumi perlawanan langsung dan yang baru tamat (dengan siaran ulangan apabila tersedia).
  • Item mula dipaparkan kira-kira 5 minit sebelum waktu sepak mula yang dijadualkan.

Titik Akhir Dikemas Kini

GET

Titik akhir ini membolehkan anda mengesan suapan pertandingan atau pasukan yang baru dikemas kini tanpa perlu meninjau setiap titik akhir secara berasingan.

Struktur Respons

Respons ialah objek JSON yang mengandungi kunci response dengan tatasusunan objek perlawanan. Setiap perlawanan merangkumi maklumat asas, butiran pertandingan berkaitan dan senarai video yang tersedia.

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": "..."}]},...]}

Kunci response mengandungi tatasusunan objek perlawanan. Setiap objek mewakili satu perlawanan bola sepak dan merangkumi medan berikut:

  • title – Nama perlawanan (contohnya Chelsea - Manchester United).
  • competition – Nama pertandingan (contohnya England Premier League).
  • date – Tarikh dan waktu sepak mula perlawanan.
  • thumbnail – URL imej kecil bagi perlawanan.
  • videos – Tatasusunan semua video yang tersedia bagi perlawanan. Setiap objek video merangkumi:
    • title – Tajuk video (contohnya Highlights atau Extended Highlights).
    • embed – Kod benam HTML bagi video.
    • id – Pengecam unik video.
  • homeTeam / awayTeam – Objek yang mewakili pasukan dalam perlawanan, termasuk:
    • name – Nama penuh pasukan (contohnya Chelsea).
    • slug – Slug pasukan yang digunakan dalam URL (contohnya chelsea).
    • id – Pengecam unik pasukan.
  • matchviewUrl – URL halaman widget paparan perlawanan yang mengandungi maklumat terperinci seperti skor langsung, statistik dan kedudukan.
  • competitionUrl – URL widget pertandingan yang memaparkan carta langsung, keputusan dan jadual perlawanan akan datang.

Main Automatik

Anda boleh mengaktifkan main automatik dengan menambahkan parameter autoplay=1 pada URL video.

Contohnya:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Jika anda menggunakan HTML embed secara langsung, anda boleh menambahkan &autoplay=1 pada URL video dalam src iframe.

Kuota

Setiap pelan mempunyai had permintaan bulanan.

  • Setiap tontonan video atau paparan widget dikira sebagai 1 permintaan.
  • Setiap panggilan kepada API Video dikira sebagai 5 permintaan daripada kuota bulanan anda.

Contohnya:

  • Pelan Starter merangkumi 5,000 permintaan sebulan.
  • Pelan Standard merangkumi 20,000 permintaan sebulan.
  • Pelan Advanced merangkumi 100,000 permintaan sebulan.
  • Jika anda memerlukan had yang lebih tinggi, hubungi kami untuk mendapatkan pelan Enterprise kami.

Jika anda melebihi had permintaan bulanan, akaun anda akan bertukar secara automatik kepada pelan Percuma sehingga tempoh pengebilan seterusnya. Dalam tempoh tersebut, iklan dan logo ScoreBat akan dipaparkan pada widget serta video, dan hanya titik akhir Free Feed boleh diakses.