Siapa yang boleh menggunakannya?
Liga dalam rancangan Emas 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 memulangkan ralat dan bukannya data anda.
Apakah ia?
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, ya"), dan LeagueRepublic membawa jawapannya.
Bagaimana anda meminta?
Anda melawat alamat web, sama seperti membuka halaman web. Daripada halaman yang cantik, anda menerima teks biasa dalam format yang dipanggil JSON. Kod pembangun web anda, atau halaman yang dibuat oleh pembantu AI, membaca teks itu dan menukarnya menjadi apa sahaja reka bentuk anda.
Bagaimanakah rupa JSON?
Ia ialah senarai label dan nilai, sedikit seperti borang yang telah diisi:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Perkataan sebelum 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 ID?
Setiap liga, musim, divisyen, pasukan dan perlawanan dalam LeagueRepublic mempunyai nombornya sendiri, dipanggil ID. Ia berfungsi seperti nombor keahlian: ia tidak pernah berubah, dan tiada dua perkara yang berkongsi nombor yang sama. Anda memasukkan ID ke dalam alamat web untuk menyatakan musim atau pasukan yang anda mahu.
Bagaimanakah saya mencari ID saya?
ID liga anda ditunjukkan di Laman Utama Admin > API > Tetapan API.
ID musim anda: buka alamat ini dalam pelayar anda, dengan ID liga anda menggantikan [ID-LIGA-SAYA]. Ia menyenaraikan musim anda, setiap satu dengan ID-nya.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-LIGA-SAYA].json
ID divisyen dan pasukan terdapat 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 sejumlah permintaan tertentu seminit, dikongsi oleh semua yang menggunakan data liga anda: laman web, aplikasi dan apa-apa sahaja yang lain. Halaman yang dibina dengan baik menyimpan apa yang dimuatkannya dan tidak meminta berulang kali. Spesifikasi API menyatakan had yang tepat.
Beberapa perkataan yang akan anda lihat
Road – pasukan pelawat. LeagueRepublic menggunakan "road" apabila kebanyakan orang menyebut "away" (di tempat lawan).
Perlawanan (fixture) – perlawanan, sama ada sudah dimainkan atau belum.
Kumpulan perlawanan (fixture group) – divisyen (seperti "Premier Division"), piala atau kumpulan perlawanan lain.
Keputusan (result) – perlawanan yang mempunyai skor.
null – kotak itu kosong. Liga tidak mengisinya, atau ia tidak berkenaan.
true / false – ya / tidak.
Di manakah butiran penuh?
Semua yang tepat, seperti setiap nama medan, had dan mesej ralat, terdapat dalam spesifikasi API: