Version

Der Version-Endpunkt (/nitro/v1/version) ist ein leichtgewichtiger Endpunkt zur Cache-Validierung. Er liefert nur zwei Felder und ist deutlich performanter als der vollständige /config-Endpunkt.

Antwort

{
  "version": 156,
  "updated_at": 1708300800
}

Schlüssel	Beschreibung
version	Eine laufende Nummer, die sich erhöht, wenn Flyo neue Daten für die Integration generiert. Ändert sich weniger häufig als updated_at.
updated_at	Unix-Timestamp der letzten Aktualisierung. Ändert sich bei jeder Aktualisierung.

Verwendung

Nutze diesen Endpunkt, um zu entscheiden, ob dein lokaler Cache noch gültig ist. Ein typisches Vorgehen:

1. Beim Start der Applikation den /config-Endpunkt aufrufen und die version speichern.
2. Für nachfolgende Anfragen nur den /version-Endpunkt abfragen.
3. Stimmt die version überein, kann der lokal gespeicherte /config-Cache weiterverwendet werden.
4. Hat sich die version verändert, /config erneut abrufen und den Cache aktualisieren.

TIP

Da version sich weniger häufig ändert als updated_at, kann ein Cache, der auf version basiert, länger gültig bleiben. Ein Cache basierend auf updated_at ist hingegen exakter, aber es wird häufiger ein erneuter /config-Abruf nötig.