跳转到主要内容

API 的工作原理

本文用通俗易懂的语言介绍 LeagueRepublic API 的基础知识。您无需任何技术知识即可看懂。

作者:Pedro Maia

谁可以使用?

使用 黄金(Gold)计划并已开启 API 的联赛。要开启 API,请前往 管理员主页 > API > API 设置,然后勾选 启用 JSON API。如果缺少其中任何一项,这些文章中的每个网址都会返回错误,而不是您的数据。

API 是什么?

API 让其他网站、应用或程序能够直接从 LeagueRepublic 读取您联赛的赛程、赛果和积分榜。可以把它想象成一名服务员:您的网站提出请求(“请给我今天的比赛”),LeagueRepublic 就把答案送回来。

如何发出请求?

您访问一个网址,就像打开一个网页一样。不过您得到的不是一个美观的页面,而是一种名为 JSON 格式的纯文本。您的网页开发人员编写的代码,或由 AI 助手制作的页面,会读取这些文本,并把它变成您设计的任何样子。

JSON 是什么样子的?

它是一串标签和值的列表,有点像一张填好的表格:

{ "homeTeamName": "Arthurlie", "homeScore": "2" }

冒号前面的词是字段名(表格上的标签)。冒号后面的部分是值(框里填写的内容)。API 规范会说明每个字段名的含义。

什么是 ID?

LeagueRepublic 中的每个联赛、赛季、级别、球队和比赛都有自己的编号,称为 ID。它就像会员编号:永远不会改变,也不会有两样东西共用同一个编号。您把 ID 放进网址里,用来说明您想要哪个赛季或哪支球队。

如何找到我的 ID?

您的联赛 ID 显示在 管理员主页 > API > API 设置 页面上。

您的赛季 ID:在浏览器中打开下面这个地址,把 [我的联赛ID] 替换为您的联赛 ID。它会列出您的所有赛季以及各自的 ID。

https://api.leaguerepublic.com/json/getSeasonsForLeague/[我的联赛ID].json

级别和球队 ID 会出现在 API 返回的列表中。如果您使用任意一篇“创建……”文章,AI 助手会替您查找这些 ID。

有限制吗?

有。每个联赛每分钟只能发出一定数量的请求,这个数量由所有使用您联赛数据的东西共享:您的网站、应用以及其他任何内容。制作良好的页面会保存已加载的内容,而不是一遍又一遍地重复请求。确切的限制请参阅 API 规范。

您会看到的一些词

Road – 客队。大多数人说“客场”的地方,LeagueRepublic 会用“road”。

比赛(fixture)– 一场比赛,无论是否已经进行。

比赛组(fixture group)– 一个级别(例如“Premier Division”)、一项杯赛或其他一组比赛。

赛果(result)– 已有比分的比赛。

null – 该项为空。联赛没有填写,或者不适用。

true / false – 是 / 否。

完整详情在哪里?

所有精确信息,例如每个字段名、请求限制和错误消息,都在 API 规范中:

这是否解答了您的问题?