Dit første kald på fem minutter

Fra ingenting til en livesession oprettet via API, uden at du forlader denne side.

Før du går i gang

  • En konto på et betalt abonnement: API'et er ikke med i FREE (du kan stadig læse hele referencen uden at betale).
  • En præsentation i dit arbejdsområde: den session, du er ved at oprette, kører en eksisterende præsentation.

  1. Opret din adgangsnøgle

    Åbn Organisation → API i dit arbejdsområde, og opret en adgangsnøgle med tilladelsen content:write. Hemmeligheden vises kun én gang: gem den.

    Hent din API-nøgle

    Adgangsnøglen tilhører organisationen, ikke din bruger: enhver administrator kan trække den tilbage, og al brug havner i revisionsloggen. Bed kun om de tilladelser, du har brug for – results:read for at læse, content:write for at oprette og styre.

  2. Opret og åbn en session

    Med din nøgle i X-API-Key-headeren opretter du en session på en eksisterende præsentation og åbner den.

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

    Sessionen fødes som DRAFT; når du åbner den, dannes dens join_code, og rummet er klar. Hold øje med X-RateLimit-*-headerne i svaret: de følger med hver gang og fortæller, hvor meget anmodningsbudget der er tilbage i vinduet på 60 sekunder.

  3. Modtag resultaterne

    Registrer et webhook til question.results.finalized, og modtag signerede opgørelser i din backend.

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

    Gem den signing_secret, som registreringen returnerer: den vises kun én gang, og det er den, der lader dig verificere hver eneste levering. Guiden til webhooks har verifikationen klar til at sætte ind i tre sprog.

Hvis noget ser forkert ud

  • 401 – X-API-Key-headeren eller tilladelsen mangler: svaret angiver præcis hvilken i required_scope.
  • 402 – dit abonnement indeholder ikke API'et: svaret indeholder upgrade_to med det abonnement, der låser det op.
  • 429 – budgettet for dette vindue er brugt: vent retry_after_seconds, og prøv igen med stigende ventetid.

Hvad så nu?

Læs hele referencen, prøv alle endpoints online, og forbind Zapier eller din agent via MCP.

API-reference →