Siapa yang boleh menggunakannya?
Liga dalam pelan Gold yang telah menghidupkan API. Untuk menghidupkannya, pergi ke Laman Utama Admin > API > Tetapan API dan tandakan Dayakan JSON API. Jika salah satu tiada, setiap alamat web dalam artikel ini akan memberikan ralat dan bukannya data anda.
Apakah itu?
API membolehkan laman web, aplikasi atau program lain membaca perlawanan, keputusan dan jadual liga anda terus daripada LeagueRepublic. Anggaplah ia seperti pelayan restoran: laman web anda meminta sesuatu ("perlawanan hari ini, tolong"), dan LeagueRepublic membawa balik jawapannya.
Bagaimana cara meminta?
Anda melawat sesuatu alamat web, sama seperti membuka halaman web. Sebaliknya daripada halaman yang cantik, anda mendapat teks biasa dalam format yang dipanggil JSON. Kod pembangun web anda, atau halaman yang dibuat oleh pembantu AI, membaca teks itu dan menukarkannya menjadi apa sahaja yang anda reka.
Bagaimana rupa JSON?
Ia ialah senarai label dan nilai, agak seperti borang yang telah diisi:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Perkataan sebelum tanda titik bertindih ialah nama medan (label pada borang). Bahagian selepasnya ialah nilai (apa yang ditulis dalam kotak). Spesifikasi API menerangkan maksud setiap nama medan.
Apakah itu ID?
Setiap liga, musim, divisyen, pasukan dan perlawanan dalam LeagueRepublic mempunyai nombornya sendiri, yang dipanggil ID. Ia berfungsi seperti nombor keahlian: ia tidak pernah berubah, dan tiada dua perkara yang berkongsi satu nombor. Anda meletakkan ID dalam alamat web untuk menyatakan musim atau pasukan yang anda mahukan.
Bagaimana saya mencari ID saya?
ID liga anda dipaparkan pada Laman Utama Admin > API > Tetapan API.
ID musim anda: buka alamat ini dalam pelayar anda, dengan ID liga anda menggantikan [MY-LEAGUE-ID]. Ia menyenaraikan musim anda, bersama ID masing-masing.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
ID divisyen dan pasukan muncul dalam senarai yang dihantar balik oleh API. Jika anda menggunakan salah satu artikel Bina…, pembantu AI akan mencarinya untuk anda.
Adakah terdapat had?
Ya. Setiap liga hanya boleh membuat bilangan permintaan tertentu seminit, dikongsi oleh semua yang menggunakan data liga anda: laman web anda, aplikasi dan apa-apa lagi. Halaman yang dibuat dengan baik menyimpan apa yang dimuatkannya dan bukannya meminta berulang kali. Spesifikasi API memberikan had yang tepat.
Beberapa perkataan yang akan anda lihat
Road – pasukan tamu. LeagueRepublic menggunakan "road" bagi maksud "away" (tamu) yang lazim digunakan kebanyakan orang.
Fixture – satu perlawanan, sama ada sudah dimainkan atau belum.
Fixture group – satu divisyen (seperti "Divisyen Perdana"), satu piala, atau kumpulan perlawanan lain.
Result – satu fixture yang mempunyai skor.
null – kotak itu kosong. Liga tidak memasukkannya, atau ia tidak berkenaan.
true / false – ya / tidak.
Di manakah butiran lengkap?
Semua yang tepat, seperti setiap nama medan, had dan mesej ralat, terdapat dalam spesifikasi API: