Ai có thể dùng?
Các giải đấu dùng gói Gold và đã bật API. Để bật, hãy vào Trang chủ quản trị > API > Cài đặt API và đánh dấu Bật JSON API (Enable JSON API). Nếu thiếu một trong hai, mọi địa chỉ web trong các bài viết này sẽ trả về lỗi thay vì dữ liệu của bạn.
API là gì?
API cho phép một trang web, ứng dụng hoặc chương trình khác đọc lịch thi đấu, kết quả và bảng xếp hạng của giải đấu bạn trực tiếp từ LeagueRepublic. Hãy hình dung nó như một người phục vụ: trang web của bạn yêu cầu một thứ gì đó ("cho tôi các trận hôm nay"), và LeagueRepublic mang câu trả lời về.
Làm thế nào để yêu cầu?
Bạn truy cập một địa chỉ web, giống như mở một trang web. Thay vì một trang trông đẹp mắt, bạn nhận lại văn bản thuần ở định dạng gọi là JSON. Mã của lập trình viên web của bạn, hoặc một trang do trợ lý AI tạo ra, sẽ đọc văn bản đó và biến nó thành bất cứ thứ gì bạn thiết kế.
JSON trông như thế nào?
Đó là một danh sách các nhãn và giá trị, hơi giống một biểu mẫu đã được điền:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Từ đứng trước dấu hai chấm là tên trường (nhãn trên biểu mẫu). Phần đứng sau là giá trị (thứ được viết trong ô). Tài liệu đặc tả API giải thích ý nghĩa của từng tên trường.
ID là gì?
Mỗi giải đấu, mùa giải, hạng đấu, đội và trận đấu trong LeagueRepublic đều có một số riêng, gọi là ID. Nó hoạt động giống như số thẻ thành viên: không bao giờ thay đổi, và không có hai thứ nào dùng chung một số. Bạn đặt các ID vào địa chỉ web để cho biết mình muốn mùa giải hoặc đội nào.
Làm sao để tìm ID của tôi?
Mã giải đấu của bạn được hiển thị tại Trang chủ quản trị > API > Cài đặt API.
Mã mùa giải của bạn: mở địa chỉ này trong trình duyệt, thay [MY-LEAGUE-ID] bằng mã giải đấu của bạn. Nó liệt kê các mùa giải của bạn, mỗi mùa kèm ID của nó.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
ID của hạng đấu và đội xuất hiện trong các danh sách mà API gửi về. Nếu bạn dùng một trong các bài viết Tạo…, trợ lý AI sẽ tra cứu chúng giúp bạn.
Có giới hạn không?
Có. Mỗi giải đấu chỉ có thể gửi một số lượng yêu cầu nhất định mỗi phút, được chia sẻ cho mọi thứ dùng dữ liệu giải đấu của bạn: trang web, ứng dụng và bất cứ thứ gì khác. Một trang được làm tốt sẽ lưu lại những gì nó đã tải thay vì hỏi đi hỏi lại. Tài liệu đặc tả API nêu giới hạn chính xác.
Một vài từ bạn sẽ gặp
Road – đội khách. LeagueRepublic dùng "road" ở chỗ hầu hết mọi người dùng "away".
Fixture – một trận đấu, dù đã diễn ra hay chưa.
Fixture group – một hạng đấu (chẳng hạn "Premier Division"), một giải cúp hoặc một nhóm trận đấu khác.
Result – một trận đấu đã có tỷ số.
null – ô trống. Giải đấu chưa nhập, hoặc không áp dụng.
true / false – có / không.
Chi tiết đầy đủ ở đâu?
Mọi thông tin chính xác, chẳng hạn từng tên trường, giới hạn và các thông báo lỗi, đều nằm trong tài liệu đặc tả API: