Přeskočit na hlavní obsah

REST

Swagger s detailnějším popisem je dostupný zde.

Autorizace

Využivá se Basic eventId:eventPassword enkódované jako Base64 řetězec, jak je vidět u PUT a POST dotazu v authorization hlavičce.

Nahrání dat

  • Endpoint: https://api.orienteerfeed.com/rest/v1/upload/iof
  • je možné volat pravidelně (například po 5ti minutách) a zpracovává se celé xml, což může něco málo trvat a není to optimální.

Aktualizace dat

Aktualizace dat je rozdělěná na dvě skupiny:

  • 1. změna statusu

    • jednoduchý endpoint pouze pro změnu statusu (Běží/Neběží)
    • URL: https://api.orienteerfeed.com/rest/v1/events/{eventId}/competitors/{competitorId}/status-change
  • 2. změna údajů závodníka

    • upravuje ostatní údaje o závodníkovi jako např. číslo čipu
    • URL: https://api.orienteerfeed.com/rest/v1/events/{eventId}/competitors/{competitorId}

Získání přehledu změn

Snadno lze získat přehled všech změn, které v průběhu závodu nastaly. Ideální je využít origin parametr (např. START) o omezit jen na konkrétní místo původu. Jde o autorizovaný endpoint ačkoliv je to GET požadavek. URL: https://api.orienteerfeed.com/rest/v1/events/{eventId}/changelog?origin=START