Vaš prvi poziv u pet minuta

Od nule do sesije uživo stvorene preko API-ja, bez izlaska s ove stranice.

Prije nego što počnete

  • Korisnički račun na plaćenom paketu: API nije dio paketa FREE (cijeli priručnik ipak možete pregledati bez plaćanja).
  • Prezentacija u Vašem prostoru: sesija koju ćete stvoriti pokreće postojeću prezentaciju.

  1. Napravite svoju vjerodajnicu

    U svojem prostoru otvorite Organizacija → API i napravite vjerodajnicu s opsegom content:write. Tajna se prikazuje jednom: spremite je.

    Nabavite svoj API ključ

    Vjerodajnica pripada organizaciji, a ne Vašem korisniku: svaki je administrator može opozvati i svaka uporaba završi u revizijskom zapisniku. Tražite samo opsege koji Vam trebaju – results:read za čitanje, content:write za stvaranje i vođenje.

  2. Stvorite i otvorite sesiju

    Sa svojim ključem u zaglavlju X-API-Key stvorite sesiju na postojećoj prezentaciji i otvorite je.

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

    Sesija se rađa u stanju DRAFT; otvaranjem dobiva svoj join_code i soba je spremna. Pratite zaglavlja X-RateLimit-* u odgovoru: putuju sa svakim odgovorom i govore Vam koliko je proračuna zahtjeva ostalo u prozoru od 60 sekundi.

  3. Primite rezultate

    Registrirajte webhook za question.results.finalized i primajte potpisane zbrojeve u svojem sustavu.

    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"] }'

    Spremite signing_secret koji registracija vraća: prikazuje se jednom i njime provjeravate svaku isporuku. Vodič za webhookove donosi provjeru spremnu za lijepljenje u tri jezika.

Ako nešto ne štima

  • 401 – nedostaje zaglavlje X-API-Key ili opseg: tijelo odgovora imenuje točan opseg u polju required_scope.
  • 402 – Vaš paket ne uključuje API: tijelo odgovora nosi upgrade_to s paketom koji ga otključava.
  • 429 – proračun je potrošen za ovaj prozor: pričekajte retry_after_seconds i pokušajte ponovno uz odgodu.

Što dalje?

Pregledajte cijeli priručnik, isprobajte svaku krajnju točku na internetu i povežite Zapier ili svojeg agenta preko MCP-a.

Priručnik za API →