谁可以使用?
使用 Gold 计划并已开启 API 的联赛。要开启它,请前往 管理员主页 > API > API 设置,并勾选 启用 JSON API(Enable JSON API)。如果缺少其中任何一项,这些文章中的每个网址都会返回错误,而不是您的数据。
它是什么?
API 让另一个网站、应用或程序可以直接从 LeagueRepublic 读取您联赛的赛程、赛果和积分榜。可以把它想象成一位服务员:您的网站提出请求(“请给我今天的比赛”),LeagueRepublic 把答案送回来。
如何提出请求?
您访问一个网址,就像打开一个网页一样。您得到的不是一个好看的页面,而是一种称为 JSON 的格式的纯文本。您的网页开发人员编写的代码,或 AI 助手制作的页面,会读取这段文本,并把它变成您设计的任何样子。
JSON 是什么样子?
它是由标签和值组成的列表,有点像一张填好的表单:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
冒号前面的词是字段名(表单上的标签)。冒号后面的部分是值(填在框里的内容)。API 规范解释了每个字段名的含义。
什么是 ID?
LeagueRepublic 中的每个联赛、赛季、级别、球队和比赛都有自己的编号,称为 ID。它的作用就像会员号:永远不会改变,也不会有两个对象共用同一个。您把 ID 放进网址中,来说明您想要哪个赛季或哪支球队。
如何找到我的 ID?
您的联赛 ID 显示在 管理员主页 > API > API 设置 页面上。
您的赛季 ID:在浏览器中打开此地址,并用您的联赛 ID 替换 [MY-LEAGUE-ID]。它会列出您的各个赛季,每个赛季都带有 ID。
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
级别和球队的 ID 会出现在 API 返回的列表中。如果您使用构建…系列文章之一,AI 助手会替您查找这些 ID。
有限制吗?
有。每个联赛每分钟只能发出一定数量的请求,这个数量由使用您联赛数据的所有对象共享:您的网站、应用以及其他任何东西。一个制作良好的页面会缓存已加载的内容,而不是一遍又一遍地请求。确切的限制请见 API 规范。
您会看到的几个词
Road – 客队。大多数人说“away”的地方,LeagueRepublic 说“road”。
Fixture – 一场比赛,无论是否已经进行。
Fixture group – 一个级别(例如“Premier Division”)、一项杯赛或另一组比赛。
Result – 已有比分的比赛。
null – 该框为空。联赛没有录入,或者不适用。
true / false – 是 / 否。
完整详情在哪里?
所有精确的内容,例如每个字段名、限制和错误信息,都在 API 规范中:
