Skip to main content
ÖffiGo bietet eine kleine, offene API. Sie ist für Dashboards, Auswertungen und eigene Projekte gedacht.

​
Grundregeln

Basis-URL

https://api.oeffigo.app

Kein Schlüssel

Alle /v1-Endpunkte sind ohne Zugangsdaten nutzbar.

Offenes CORS

Jede Antwort trägt Access-Control-Allow-Origin: *.

Rate-Limit

120 Anfragen pro Minute und IP. Darüber: 429 mit Retry-After: 30.

​
Fehler

Fehler kommen immer im selben Format mit passendem HTTP-Status:

​
Caching

  • Fehler sind immer no-store.
  • Erfolgreiche Antworten tragen ein Cache-Control passend dazu, wie schnell sich die Daten ändern – verlass dich auf den Header.
  • /v1/predictions unterstützt ETag und If-None-Match: Solange sich nichts geändert hat, bekommst du ein 304 ohne Body.

​
Versionierung

  • Brechende Änderungen bekommen einen neuen Pfad.
  • Zusätzliche Felder können jederzeit dazukommen – ignoriere Felder, die du nicht kennst.
/v2 ist der App-Vertrag, keine offene API. Schema (/v2/schema) und Routenliste (/v2/meta) sind lesbar, die Datenrouten lehnen Anfragen von außen aber ab und verlangen ein Installations-Token, das nur die Apps erhalten. Bau bitte nichts, das auf /v2 angewiesen ist.

Alle Endpunkte

Parameter, Beispiele und Antworten.