Actigo
  • Actigo
  • Uživatelé
    • Jak to funguje
    • Ovládání aplikace
    • Příspěvky a upozornění
    • Sledování a sdílení mezi uživateli
    • Import a a sdílení individuálních aktivit
    • Vyhledávání a sledování pořádaných aktivit (závodů)
    • Registrace na aktivitu (závod)
    • Výsledky závodů
    • Zrušení uživatelského účtu
  • Pořadatelé
    • Jak se stát pořadatelem
    • Vytvoření a správa závodu
  • API
    • Základní principy
    • Registrace a výsledky
      • Stahování registrací
      • Synchronizace registrací
      • Stahování výsledků
      • Synchronizace výsledků
Powered by GitBook
On this page

Was this helpful?

  1. API

Základní principy

PreviousVytvoření a správa závoduNextRegistrace a výsledky

Last updated 2 years ago

Was this helpful?

Actigo poskytuje dva typy API

  1. GraphQL s na adrese určené primárně pro integraci uživatelských rozhraní (webové a mobilní aplikace)

  2. REST na adresách ve tvaru https://actigo.app/api/{module}/{resource-path...}, s dokumentací ve formátu OpenAPI dostupné na adrese , kterou lze prohlížet a testovat prostřednictvím . REST API je určené primárně pro integraci jiných systémů (např. stahování / aktualizaci registrací a import oficiálních výsledků pořádaných aktivit-závodů ze strany pořadatelů či s jimi asociovaných časoměřičů)

Většina operací/metod poskytovaných API, jmenovitě pak všechny provádějící změny v datech vyžaduje autorizaci. Pro tu je potřeba si po přihlášení do aplikace na adrese (položka Pro vývojáře v menu pod ikonou přihlášeného uživatele) vygenerovat přístupové klíče.

Při vytváření přístupového klíče můžete předgenerovaný název (name) i tajemství (secret) změnit na libovolnou hodnotu, zvláště pak secret nechte pokud možno co nejsložitější. Využijte popis pro jednoznačnou identifikací klíče (např. "Testovací verze webu mujzavod.cz")

Ty se předávají ve voláních API v HTTP hlavičce pořadavku Authorization a to ve formě

"Basic " + BASE64("keyName:keySecret")

Příklad:

Authorization: Basic AbcdefghijklmnopqrstuvwxyzABCDEF

Přístup ke konkrétním datům či rozsah jejich zobrazení ve výsledcích volání metod API může být omezen právy uživatele, kterým byl použitý přístupový klíč vytvořen. Obecně platí, že API poskytuje data pouze v rozsahu v jakém jsou uživateli k dispozici prostřednictvím uživatelského rozhraní, tedy konkrétně

  • Veřejně dostupné informace o publikovaných pořádaných aktivitách, výsledcích a uživatelských aktivitách uživatele s veřejným profilem všem přístupovým klíčům (případně i bez použití klíče)

  • Detailní, veřejně nedostupné informace o registracích, nepublikovaných pořádaných aktivitách (závodech) a uživatelských aktivitách uživatele s neveřejným profilem pouze klíčům uživatelů, kteří mají k daným datům přístup (tj. jsou-li součástí pořadatelského týmu, případně spolupořadatelského či časoměřičského týmu s pořadatelem asociovaného, přátelé uživatele vlastnícího danou uživatelskou aktivitu atd.)

https://actigo.app/graphql
https://actigo.app/openapi.json
webového rozhraní
https://actigo.app/developers