Ai có thể sử dụng?
Các giải đấu dùng gói Vàng (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. Nếu thiếu một trong hai điều này, 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 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 đến.
Yêu cầu dữ liệu như thế nào?
Bạn truy cập một địa chỉ web, giống như mở một trang web. Thay vì một trang đẹ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 nhà phát triển web, 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ị (nội dung đã được điền vào ô). Đặ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 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 đưa ID vào địa chỉ web để cho biết bạn muốn mùa giải hoặc đội nào.
Làm sao tìm ID của tôi?
ID giải đấu của bạn được hiển thị tại Trang chủ quản trị > API > Cài đặt API.
ID mùa giải của bạn: mở địa chỉ này trong trình duyệt, thay [ID-GIẢI-ĐẤU-CỦA-TÔI] bằng ID giải đấu của bạn. Địa chỉ này liệt kê các mùa giải của bạn, mỗi mùa kèm ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-GIẢI-ĐẤU-CỦA-TÔI].json
ID hạng đấu và ID độ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ẽ tự tra cứu giúp bạn.
Có giới hạn không?
Có. Mỗi giải đấu chỉ được gửi một số lượng yêu cầu nhất định mỗi phút, dùng chung cho mọi thứ sử dụng dữ liệu của giải đấu: 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ì đã tải thay vì hỏi đi hỏi lại. Đặc tả API nêu rõ 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ỗ mà hầu hết mọi người nói "sân khách".
Trận đấu (fixture) – một trận, dù đã đá hay chưa.
Nhóm trận đấu (fixture group) – một hạng đấu (chẳng hạn "Premier Division"), một cúp hoặc một nhóm trận đấu khác.
Kết quả (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.
Thông tin chi tiết đầy đủ ở đâu?
Mọi thông tin chính xác, như từng tên trường, giới hạn và các thông báo lỗi, đều có trong đặc tả API: