Siapa yang dapat menggunakannya?
Liga dengan paket Emas yang telah mengaktifkan API. Untuk mengaktifkannya, buka Beranda Admin > API > Pengaturan API lalu centang Aktifkan JSON API. Jika salah satunya tidak ada, setiap alamat web dalam artikel-artikel ini akan menampilkan error, bukan data Anda.
Apa itu?
API memungkinkan situs web, aplikasi, atau program lain membaca jadwal pertandingan, hasil, dan klasemen liga Anda langsung dari LeagueRepublic. Bayangkan seperti pelayan: situs web Anda meminta sesuatu ("pertandingan hari ini, ya"), lalu LeagueRepublic membawakan jawabannya.
Bagaimana cara meminta data?
Anda membuka sebuah alamat web, sama seperti membuka halaman web. Alih-alih halaman yang tampil rapi, Anda menerima teks biasa dalam format bernama JSON. Kode buatan pengembang web Anda, atau halaman yang dibuat oleh asisten AI, membaca teks itu dan mengubahnya menjadi tampilan apa pun yang Anda rancang.
Seperti apa bentuk JSON?
Isinya berupa daftar label dan nilai, mirip seperti formulir yang sudah diisi:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Kata sebelum titik dua adalah nama field (label pada formulir). Bagian setelahnya adalah nilai (apa yang ditulis di kotaknya). Spesifikasi API menjelaskan arti setiap nama field.
Apa itu ID?
Setiap liga, musim, divisi, tim, dan pertandingan di LeagueRepublic memiliki nomornya sendiri, yang disebut ID. Cara kerjanya seperti nomor anggota: tidak pernah berubah, dan tidak ada dua hal yang memiliki ID yang sama. Anda memasukkan ID ke dalam alamat web untuk menunjukkan musim atau tim mana yang Anda inginkan.
Bagaimana cara menemukan ID saya?
ID liga Anda ditampilkan di Beranda Admin > API > Pengaturan API.
ID musim Anda: buka alamat ini di browser, dengan ID liga Anda sebagai pengganti [ID-LIGA-SAYA]. Alamat ini menampilkan daftar musim Anda, masing-masing dengan ID-nya.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-LIGA-SAYA].json
ID divisi dan tim muncul dalam daftar yang dikirim kembali oleh API. Jika Anda menggunakan salah satu artikel Membuat…, asisten AI akan mencarikannya untuk Anda.
Apakah ada batasnya?
Ya. Setiap liga hanya dapat membuat sejumlah permintaan tertentu per menit, yang dipakai bersama oleh semua hal yang menggunakan data liga Anda: situs web, aplikasi, dan lainnya. Halaman yang dibuat dengan baik menyimpan apa yang sudah dimuatnya, alih-alih meminta lagi dan lagi. Spesifikasi API mencantumkan batas pastinya.
Beberapa istilah yang akan Anda temui
Road – tim tamu. LeagueRepublic menggunakan kata "road" untuk hal yang biasanya disebut "away" (tandang).
Pertandingan (fixture) – sebuah pertandingan, baik yang sudah dimainkan maupun belum.
Grup pertandingan (fixture group) – sebuah divisi (misalnya "Premier Division"), piala, atau kelompok pertandingan lainnya.
Hasil – pertandingan yang sudah memiliki skor.
null – kotaknya kosong. Liga tidak mengisinya, atau memang tidak berlaku.
true / false – ya / tidak.
Di mana detail lengkapnya?
Semua detail yang pasti, seperti setiap nama field, batas permintaan, dan pesan error, ada di spesifikasi API: