Vaše první volání za pět minut

Od nuly k živé relaci vytvořené přes API, aniž byste opustili tuhle stránku.

Než začnete

  • Účet v placeném tarifu: API není součástí tarifu FREE (celou referenci si ale můžete projít i bez placení).
  • Prezentace ve Vašem prostoru: relace, kterou se chystáte vytvořit, spouští existující prezentaci.

  1. Vytvořte si pověření

    Ve svém prostoru otevřete Organizace → API a vytvořte pověření s oprávněním content:write. Tajný klíč se ukáže jen jednou: uložte si ho.

    Získat klíč k API

    Pověření patří organizaci, ne vašemu uživateli: odvolat ho může kterýkoli správce a každé použití se zapíše do protokolu auditu. Žádejte jen o oprávnění, která potřebujete – results:read na čtení, content:write na vytváření a řízení.

  2. Vytvořte a otevřete relaci

    S klíčem v hlavičce X-API-Key vytvořte relaci nad existující prezentací a otevřete ji.

    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_…"

    Relace vzniká ve stavu DRAFT; otevřením se jí vytvoří kód relace a místnost je připravená. Sledujte v odpovědi hlavičky X-RateLimit-*: cestují v každé odpovědi a říkají, kolik rozpočtu na požadavky ještě zbývá v okně 60 sekund.

  3. Přijměte výsledky

    Zaregistrujte webhook pro question.results.finalized a dostávejte do svého backendu podepsané souhrny.

    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, který registrace vrátí: ukáže se jen jednou a je to on, čím ověříte každé doručení. Průvodce webhooky nabízí ověření připravené ke vložení ve třech jazycích.

Když něco nesedí

  • 401 – chybí hlavička X-API-Key nebo oprávnění: tělo odpovědi to přesné jméno uvádí v required_scope.
  • 402 – Váš tarif API neobsahuje: tělo odpovědi nese upgrade_to s tarifem, který ho odemkne.
  • 429 – rozpočet pro toto okno je vyčerpaný: počkejte retry_after_seconds a zkuste to znovu s prodlevou.

Co dál?

Projděte si celou referenci, vyzkoušejte online každý koncový bod a připojte Zapier nebo svého agenta přes MCP.

Reference API →