Ditt första anrop på fem minuter

Från noll till en livesession skapad via API, utan att lämna den här sidan.

Innan du börjar

  • Ett konto med ett betalt abonnemang: API:et ingår inte i FREE (du kan ändå bläddra i hela referensen utan att betala).
  • En presentation i din arbetsyta: sessionen du ska skapa kör en befintlig presentation.

  1. Skapa din autentiseringsuppgift

    Öppna Organisation → API i din arbetsyta och skapa en autentiseringsuppgift med scopet content:write. Hemligheten visas en enda gång: spara den.

    Hämta din API-nyckel

    Autentiseringsuppgiften tillhör organisationen, inte din användare: vilken administratör som helst kan återkalla den, och varje användning hamnar i granskningsloggen. Begär bara de scopes du behöver – results:read för att läsa, content:write för att skapa och styra.

  2. Skapa och öppna en session

    Med din nyckel i headern X-API-Key skapar du en session på en befintlig presentation och öppnar 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öds i DRAFT; när du öppnar den skapas dess join_code och rummet är redo. Håll koll på headers med X-RateLimit-* i svaret: de följer med varje svar och visar hur mycket anropsbudget som är kvar i 60-sekundersfönstret.

  3. Ta emot resultaten

    Registrera en webhook för question.results.finalized och ta emot signerade aggregat 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"] }'

    Spara den signing_secret som registreringen returnerar: den visas en enda gång, och det är den som gör att du kan verifiera varje leverans. Guiden till webhooks har verifieringen färdig att klistra in på tre språk.

Om något ser fel ut

  • 401 – headern X-API-Key eller scopet saknas: svarskroppen anger exakt vilket i required_scope.
  • 402 – ditt abonnemang omfattar inte API:et: svarskroppen innehåller upgrade_to med det abonnemang som låser upp det.
  • 429 – budgeten är slut för det här fönstret: vänta retry_after_seconds och försök igen med backoff.

Vad händer sen?

Bläddra i hela referensen, testa varje endpoint online och koppla in Zapier eller din agent via MCP.

API-referens →