Prima apelare în cinci minute

De la zero la o sesiune în direct creată prin API, fără să părăsiți această pagină.

Înainte de a începe

  • Un cont pe un plan plătit: API-ul nu face parte din FREE (puteți totuși răsfoi întreaga referință fără să plătiți).
  • O prezentare în spațiul Dumneavoastră de lucru: sesiunea pe care urmează să o creați rulează o prezentare existentă.

  1. Creați credențiala

    În spațiul Dumneavoastră de lucru, deschideți Organizație → API și creați o credențială cu permisiunea content:write. Secretul se afișează o singură dată: salvați-l.

    Obțineți cheia API

    Credențiala aparține organizației, nu utilizatorului Dumneavoastră: orice administrator o poate revoca, iar fiecare utilizare ajunge în jurnalul de audit. Cereți doar permisiunile de care aveți nevoie – results:read pentru citire, content:write pentru a crea și a conduce.

  2. Creați și deschideți o sesiune

    Cu cheia în antetul X-API-Key, creați o sesiune pe o prezentare existentă și deschideți-o.

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

    Sesiunea se naște în stare DRAFT; deschiderea îi generează codul de acces, iar sala este gata. Urmăriți anteturile X-RateLimit-* din răspuns: ele călătoresc cu fiecare replică și vă spun cât buget de cereri a mai rămas în fereastra de 60 de secunde.

  3. Primiți rezultatele

    Înregistrați un webhook pentru question.results.finalized și primiți agregatele semnate în sistemul Dumneavoastră.

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

    Salvați secretul signing_secret pe care îl întoarce înregistrarea: se afișează o singură dată și este ceea ce vă lasă să verificați fiecare livrare. Ghidul webhookurilor conține verificarea gata de lipit, în trei limbaje.

Dacă ceva pare în neregulă

  • 401 – lipsește antetul X-API-Key sau permisiunea: corpul răspunsului o numește exact, în required_scope.
  • 402 – planul Dumneavoastră nu include API-ul: corpul răspunsului aduce upgrade_to, cu planul care îl deblochează.
  • 429 – bugetul ferestrei s-a epuizat: așteptați retry_after_seconds și reîncercați progresiv.

Ce urmează?

Răsfoiți referința completă, încercați online fiecare punct final și conectați Zapier sau agentul Dumneavoastră prin MCP.

Referința API →