Siapa yang bisa menggunakannya?
Liga dengan paket Gold yang sudah mengaktifkan API. Untuk mengaktifkannya, buka Beranda Admin > API > Pengaturan API dan centang Aktifkan JSON API. Jika salah satunya belum terpenuhi, setiap alamat web di artikel-artikel ini akan mengembalikan error, bukan data Anda.
Apa itu API?
API memungkinkan situs web, aplikasi, atau program lain membaca jadwal pertandingan, hasil, dan klasemen liga Anda langsung dari LeagueRepublic. Anggap saja seperti pelayan restoran: situs web Anda meminta sesuatu ("pertandingan hari ini, tolong"), lalu LeagueRepublic membawakan jawabannya.
Bagaimana cara memintanya?
Anda membuka sebuah alamat web, sama seperti membuka halaman web. Alih-alih halaman yang tampil menarik, Anda mendapat teks biasa dalam format bernama JSON. Kode dari web developer Anda, atau halaman yang dibuat oleh asisten AI, membaca teks itu dan mengubahnya menjadi tampilan sesuai desain Anda.
Seperti apa tampilan JSON?
JSON adalah daftar label dan nilai, mirip formulir yang sudah diisi:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Kata sebelum tanda 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 punya nomornya sendiri, yang disebut ID. Fungsinya seperti nomor anggota: tidak pernah berubah, dan tidak ada dua hal yang memakai nomor yang sama. Anda memasukkan ID ke alamat web untuk menyebutkan musim atau tim 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 Anda, dengan ID liga Anda menggantikan [MY-LEAGUE-ID]. Alamat itu menampilkan daftar musim Anda, masing-masing dengan ID-nya.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
ID divisi dan tim muncul dalam daftar yang dikirim kembali oleh API. Jika Anda memakai salah satu artikel Membuat…, asisten AI akan mencarikannya untuk Anda.
Apakah ada batasan?
Ya. Setiap liga hanya dapat mengirim sejumlah permintaan tertentu per menit, dan jumlah itu dibagi untuk semua yang memakai data liga Anda: situs web, aplikasi, dan hal lainnya. Halaman yang dibuat dengan baik menyimpan apa yang sudah dimuat, bukan meminta lagi berulang kali. Batas persisnya tercantum di spesifikasi API.
Beberapa istilah yang akan Anda temui
Road – tim tandang. LeagueRepublic menyebutnya "road", padahal kebanyakan orang bilang "away" (tandang).
Fixture – sebuah pertandingan, entah sudah dimainkan atau belum.
Fixture group – sebuah divisi (misalnya "Premier Division"), turnamen piala, atau kelompok pertandingan lainnya.
Result – fixture yang sudah memiliki skor.
null – kotaknya kosong. Liga tidak mengisinya, atau datanya 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: