Vaše prvé volanie za päť minút

Od nuly po živú reláciu vytvorenú cez API, bez toho, aby ste opustili túto stránku.

Skôr než začnete

  • Účet v platenom pláne: API nie je súčasťou plánu FREE (celú príručku si však môžete prezerať aj bez platenia).
  • Prezentácia vo Vašom pracovnom priestore: relácia, ktorú ideme vytvoriť, spúšťa existujúcu prezentáciu.

  1. Vytvorte si prihlasovacie údaje

    Vo svojom pracovnom priestore otvorte Organizácia → API a vytvorte prihlasovacie údaje s oprávnením content:write. Tajný kľúč sa zobrazí iba raz: uložte si ho.

    Získať kľúč k API

    Prihlasovacie údaje patria organizácii, nie Vášmu používateľovi: ktorýkoľvek správca ich môže zrušiť a každé použitie sa zapíše do záznamu auditu. Žiadajte len tie oprávnenia, ktoré potrebujete – results:read na čítanie, content:write na vytváranie a riadenie.

  2. Vytvorte a otvorte reláciu

    S kľúčom v hlavičke X-API-Key vytvorte reláciu na existujúcej prezentácii a otvorte ju.

    curl -X POST https://api.votinova.prd.atbionapps.com/public/v1/sessions \
  -H "X-API-Key: vz_live_…" \
  -d '{ "presentation_id": "prs_8f3k2" }'

curl -X POST https://api.votinova.prd.atbionapps.com/public/v1/sessions/ses_71xw9/open \
  -H "X-API-Key: vz_live_…"

    Relácia vzniká v stave DRAFT; jej otvorením sa vygeneruje join_code a miestnosť je pripravená. Sledujte v odpovedi hlavičky X-RateLimit-*: cestujú v každej odpovedi a hovoria Vám, koľko rozpočtu na požiadavky zostáva v 60-sekundovom okne.

  3. Prijímajte výsledky

    Zaregistrujte webhook na udalosť question.results.finalized a dostávajte podpísané súhrny do svojho backendu.

    curl -X POST https://api.votinova.prd.atbionapps.com/public/v1/webhooks \
  -H "X-API-Key: vz_live_…" \
  -d '{ "url": "https://example.com/hooks/votinova",
        "event_types": ["question.results.finalized"] }'

    Uložte si signing_secret, ktorý registrácia vráti: zobrazí sa iba raz a práve ním overíte každé doručenie. Príručka k webhookom prináša overenie pripravené na skopírovanie v troch jazykoch.

Ak sa niečo nezdá

  • 401 – chýba hlavička X-API-Key alebo oprávnenie: telo odpovede pomenuje to chýbajúce v poli required_scope.
  • 402 – Váš plán API neobsahuje: telo odpovede nesie upgrade_to s plánom, ktorý ho odomkne.
  • 429 – rozpočet tohto okna je vyčerpaný: počkajte retry_after_seconds a skúste to znova s narastajúcim odstupom.

Čo ďalej?

Prezrite si celú príručku, vyskúšajte online každý koncový bod a pripojte Zapier alebo svojho agenta cez MCP.

Referenčná príručka API →