Wer kann sie nutzen?
Ligen mit dem Gold-Plan, die die API eingeschaltet haben. Zum Einschalten gehen Sie zu Admin-Startseite > API > API-Einstellungen und setzen ein Häkchen bei JSON-API aktivieren. Fehlt eines davon, 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 Spiele, Ergebnisse und Tabellen Ihrer Liga direkt aus LeagueRepublic lesen. Stellen Sie sie sich wie einen Kellner vor: Ihre Website bestellt etwas („die heutigen Spiele, bitte“), und LeagueRepublic bringt die Antwort.
Wie fragt man Daten ab?
Sie rufen eine Webadresse auf, genau wie beim Öffnen einer Webseite. Statt einer schön gestalteten Seite erhalten Sie einfachen Text in einem Format namens JSON. Der Code Ihres Webentwicklers oder eine von einem KI-Assistenten erstellte Seite liest diesen Text und macht daraus das, was Sie gestalten.
Wie sieht JSON aus?
Es ist eine Liste von Bezeichnungen und Werten, ein bisschen wie ein ausgefülltes Formular:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Das Wort vor dem Doppelpunkt ist der Feldname (die Bezeichnung im Formular). Der Teil danach ist der Wert (das, was in das 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. Sie funktioniert wie eine Mitgliedsnummer: Sie ändert sich nie, und keine zwei Dinge haben dieselbe. Sie setzen 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 Ihre Liga-ID anstelle von [MEINE-LIGA-ID] ein. Sie listet Ihre Saisons auf, jeweils mit ihrer ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MEINE-LIGA-ID].json
Divisions- und Team-IDs stehen in den Listen, die die API zurückschickt. Wenn Sie einen der Artikel Erstellen Sie… verwenden, sucht der KI-Assistent sie für Sie heraus.
Gibt es ein Limit?
Ja. Jede Liga kann nur eine bestimmte Anzahl von Anfragen pro Minute stellen, und diese teilen sich alle, die die Daten Ihrer Liga nutzen: Ihre Website, Apps und alles andere. Eine gut gemachte Seite speichert, was sie geladen hat, statt immer wieder neu zu fragen. Das genaue Limit steht in der API-Spezifikation.
Ein paar Begriffe, die Ihnen begegnen
Road – die Auswärtsmannschaft. 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, für das es ein Ergebnis gibt.
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, wie jeder Feldname, das Limit und die Fehlermeldungen, stehen in der API-Spezifikation: