Tippspiel

API

Die Lese-Endpunkte sind oeffentlich. Dadurch kannst du sie direkt im Browser oder per curl pruefen.

Schreib-Endpunkte brauchen weiterhin den Editor-Token von steven-agent. Den Token nicht in die URL schreiben, sondern als Header senden:

export TIPPSPIEL_TOKEN="<STEVE_TOKEN>"
export TIPPSPIEL_URL="https://tippspiel.kutschenator.de"

Oeffentlich lesen

Alle gespeicherten Tipps:

curl "$TIPPSPIEL_URL/api/tips"

Alle Spiele:

curl "$TIPPSPIEL_URL/api/fixtures"

Jedes Spiel enthaelt match_number fuer die offizielle Anzeige als Mxx. Laufende Spiele enthalten den aktuellen API-Football-Spielstand in result_home / result_away; gewertet wird trotzdem erst nach FT, AET oder PEN.

Aktuelle Rangliste:

curl "$TIPPSPIEL_URL/api/scorecard"

Ergebnis-Tipp setzen

Der Bot darf fuer jeden Spieler schreiben. Der Spieler wird ueber den Username oder die Player-ID adressiert.

curl -X PUT \
  -H "X-API-Token: $TIPPSPIEL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"home":0,"away":1}' \
  "$TIPPSPIEL_URL/api/tips/conrad/match/1489390"

Antwort bei Erfolg:

{"ok": true}

Wichtige Fehler:

Status Bedeutung
400 Ungueltige Eingabe, z.B. negativer Score
401 Token fehlt oder ist falsch
404 Spieler oder Spiel nicht gefunden
409 Tipp ist gesperrt

Gruppen-Tipp setzen

curl -X PUT \
  -H "X-API-Token: $TIPPSPIEL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"first_team":"Mexico","second_team":"South Africa"}' \
  "$TIPPSPIEL_URL/api/tips/conrad/group/Group%20A"

Team-Namen muessen den API-Football-Namen entsprechen. Die Weboberflaeche zeigt deutsche Namen, aber die API verwendet die internen Namen aus /api/fixtures.

Report Card

Letztes abgeschlossenes Spiel als SVG:

curl "$TIPPSPIEL_URL/api/reports/matches/latest.svg" \
  -o report.svg

Bestimmtes Spiel als SVG:

curl "$TIPPSPIEL_URL/api/reports/matches/1489390.svg" \
  -o report.svg

Die Report Card enthaelt Ergebnis, Gesamtstand, Tipp pro Spieler und Punkte fuer dieses Spiel.

Tippkarte

Naechster noch nicht gestarteter Spieltag als SVG:

curl "$TIPPSPIEL_URL/api/reports/tippkarte/next.svg" \
  -o tippkarte.svg

Die Tippkarte enthaelt die Matchnummern (M29 usw.), alle Tipps pro Spieler und die Mehrheits-Tendenz pro Spiel.

Hinweise