Vom Meldeschluss zur Rangliste: der Ablauf für Auswerter

Nimm die API, wenn deine Software IOF-XML 3.0 per HTTP senden kann. Nur so gibt es Live-Ranglisten. Kann sie das nicht, reicht der Datei-Export: Anmeldungen als CSV holen, Resultate am Schluss als Datei hochladen.

API oder Datei

Du kannst beides mischen, zum Beispiel Anmeldungen per CSV und Resultate per API. Dann fehlt dir aber meist die Id der Anmeldung. Lies dazu Personen und Teams richtig zurückmelden und Exporte für die Auswertungssoftware.

Ablauf mit der API

1. Vor dem Meldeschluss: Hole den Token und teste ihn mit GET /iof/v1/eventlist. Event/Id in der Antwort ist die Id des Laufs für alle weiteren Aufrufe.
2. Nach dem Meldeschluss: Hole die Anmeldungen mit GET entrylist. Die Liste ist immer der Gesamtstand, also hole sie nach Mutationen neu. Merke dir pro Anmeldung die Id, du brauchst sie beim Zurückmelden.
3. Startliste: Erstelle sie in deiner Software. Das Hochladen ist freiwillig, die Resultate brauchen sie nicht. Sie ist danach öffentlich. Lade sie vor dem ersten Resultat hoch und danach nicht mehr, sonst löschst du Zeit, Rang und Status. Mehr dazu unter Start- und Resultatlisten hochladen.
4. Funkposten: Lege sie vor dem Lauf an, wenn du Zwischenzeiten live zeigen willst. Siehe Live-Ranglisten und Funkposten.
5. Am Lauftag: Lade die Resultatliste regelmässig hoch. Die öffentliche Seite aktualisiert sich von selbst.
6. Zum Schluss: Lade die letzte vollständige Resultatliste hoch und kontrolliere die Rangliste. Setze dann unter Resultate bearbeiten das Häkchen Rennen beendet.

Ablauf mit Dateien

1. Lade unter Exports die Datei für deine Software herunter. Nach Mutationen brauchst du eine neue Datei, sie zeigt nur den Stand beim Herunterladen.
2. Werte den Lauf in deiner Software aus.
3. Lade die Resultate als IOF-XML von Hand hoch.

Alle Felder und Beispiele stehen in der API-Dokumentation.