Wer kann sie nutzen?
Ligen im Gold-Tarif, die die API aktiviert haben. Um sie zu aktivieren, gehen Sie zu Admin-Startseite > API > API-Einstellungen und setzen Sie ein Häkchen bei JSON-API aktivieren. Fehlt eines von beiden, liefert jede Webadresse in diesen Artikeln eine Fehlermeldung statt Ihrer Daten.
Was ist das?
Mit der API kann eine andere Website, App oder ein anderes Programm die Spielpläne, Ergebnisse und Tabellen Ihrer Liga direkt von LeagueRepublic lesen. Stellen Sie sich einen Kellner vor: Ihre Website bestellt etwas („die heutigen Spiele, bitte“), und LeagueRepublic bringt die Antwort.
Wie fragt man an?
Sie rufen eine Webadresse auf, genau wie beim Öffnen einer Webseite. Statt einer hübschen Seite erhalten Sie reinen Text in einem Format namens JSON. Der Code Ihres Webentwicklers oder eine von einem KI-Assistenten erstellte Seite liest diesen Text und macht daraus, was Sie gestalten.
Wie sieht JSON aus?
Es ist eine Liste aus Bezeichnungen und Werten, ein bisschen wie ein ausgefülltes Formular:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Das Wort vor dem Doppelpunkt ist der Feldname (die Bezeichnung auf dem Formular). Das, was danach kommt, ist der Wert (das, was ins Feld geschrieben wurde). Die API-Spezifikation erklärt, was jeder Feldname bedeutet.
Was ist eine ID?
Jede Liga, Saison, Division, jedes Team und jedes Spiel in LeagueRepublic hat eine eigene Nummer, die ID genannt wird. Sie funktioniert wie eine Mitgliedsnummer: Sie ändert sich nie, und keine zwei Dinge teilen sich eine. Sie geben IDs in die Webadresse ein, um anzugeben, welche Saison oder welches Team Sie möchten.
Wie finde ich meine IDs?
Ihre Liga-ID wird unter Admin-Startseite > API > API-Einstellungen angezeigt.
Ihre Saison-ID: Öffnen Sie diese Adresse in Ihrem Browser und setzen Sie anstelle von [MY-LEAGUE-ID] Ihre Liga-ID ein. Sie listet Ihre Saisons mit der jeweiligen ID auf.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
Division- und Team-IDs erscheinen in den Listen, die die API zurücksendet. Wenn Sie einen der Artikel „Erstellen …“ verwenden, sucht der KI-Assistent diese für Sie heraus.
Gibt es ein Limit?
Ja. Jede Liga darf pro Minute nur eine bestimmte Anzahl von Anfragen stellen, die sich alle teilen, die Ihre Ligadaten nutzen: Ihre Website, Apps und alles andere. Eine gut gemachte Seite speichert, was sie geladen hat, anstatt immer wieder neu anzufragen. Die genaue Grenze steht in der API-Spezifikation.
Ein paar Begriffe, die Ihnen begegnen werden
Road – das Auswärtsteam. LeagueRepublic sagt „road“, wo die meisten „auswärts“ sagen.
Fixture – ein Spiel, egal ob es schon gespielt wurde oder nicht.
Fixture group – eine Division (zum Beispiel „Premier Division“), ein Pokal oder eine andere Gruppe von Spielen.
Result – ein Spiel mit einem Ergebnis.
null – das Feld ist leer. Die Liga hat nichts eingetragen, oder es trifft nicht zu.
true / false – ja / nein.
Wo finde ich alle Details?
Alle genauen Angaben, etwa jeder Feldname, das Limit und die Fehlermeldungen, stehen in der API-Spezifikation: