LeagueRepublic API cho phép trang web, ứng dụng hoặc chương trình của riêng bạn đọc các mùa giải, lịch thi đấu, kết quả, bảng xếp hạng, đội và số liệu thống kê của giải đấu bạn trực tiếp từ LeagueRepublic. API chỉ cho phép đọc: không thể thay đổi bất cứ điều gì trong giải đấu của bạn thông qua nó.
Những gì bạn cần
Gói Gold. API là một phần của gói đăng ký Gold.
Đã bật API. Vào Trang chủ quản trị > API > Cài đặt API và đánh dấu Bật JSON API (Enable JSON API). Bạn có thể tắt lại bất cứ lúc nào.
Người xây dựng bằng API. Một lập trình viên web, hoặc một trợ lý AI như ChatGPT hay Claude. Các bài viết Tạo… bên dưới cung cấp hướng dẫn làm sẵn để bạn dán vào trợ lý AI.
Bước 1: Bật API
Trong phần quản trị giải đấu của bạn, 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). Cùng trang này hiển thị mã giải đấu của bạn, mà bạn cần cho bước tiếp theo.
Bước 2: Tìm ID của bạn
Mỗi mùa giải, hạng đấu và đội đều có số ID riêng. Bạn dùng chúng để cho biết mình muốn dữ liệu nào. Bài viết “API hoạt động như thế nào” giải thích về ID và cách tìm ID của bạn.
Bước 3: Chọn cách xây dựng
Với trợ lý AI: chọn bài viết phù hợp với thứ bạn muốn xây dựng và làm theo.
Với lập trình viên: Hãy thử mà không cần giải đấu của riêng bạn. Các địa chỉ này dùng giải đấu demo của LeagueRepublic, nên bạn có thể thấy phản hồi thật ngay lập tức:
Mùa giải:
Các đội trong một hạng đấu: https://api.leaguerepublic.com/json/getTeamsForFixtureGroup/1/985736993.json
Mọi trận trong mùa giải: https://api.leaguerepublic.com/json/getFixturesForSeason/153020000.json
Các trận của một đội: https://api.leaguerepublic.com/json/getFixturesForTeam/153020000/154033156.json
Match Hub:
Số liệu thống kê của một đội: https://api.leaguerepublic.com/json/getStatisticSummaryForTeam/153020000/154033156.json
hãy gửi cho họ tài liệu đặc tả API. Tài liệu liệt kê mọi dịch vụ, trường, giới hạn và thông báo lỗi.
Cũng có phiên bản văn bản thuần của cùng tài liệu đặc tả này dành cho các công cụ AI:
Cần biết
Có giới hạn về số yêu cầu mà giải đấu của bạn có thể gửi mỗi phút. Giới hạn này được chia sẻ cho mọi thứ dùng dữ liệu giải đấu của bạn. Các trang nên lưu những gì chúng đã tải thay vì hỏi đi hỏi lại. Tài liệu đặc tả nêu chi tiết.
Chỉ hiển thị các kết quả đã được phê duyệt, trừ trên Match Hub, nơi cũng hiển thị các kết quả trực tiếp và chưa phê duyệt, được đánh dấu rõ ràng.
Mọi thứ bị ẩn trên trang web giải đấu của bạn vẫn bị ẩn trong API.
Chưa chắc API phù hợp với bạn?
Nếu bạn không muốn tự xây dựng gì, Code Snippets và League Embed sẽ đưa dữ liệu giải đấu của bạn lên trang web mà không cần viết mã. Xem “Cách tích hợp nào phù hợp với tôi?”.
LeagueRepublic không cung cấp dịch vụ xây dựng trang web hay ứng dụng tùy chỉnh cho bạn.