Dein erster Aufruf in fünf Minuten

Von null zu einer per API erstellten Live-Session, ohne diese Seite zu verlassen.

Bevor du loslegst

  • Ein Konto mit Bezahlplan: Die API ist nicht Teil von FREE (die komplette Referenz kannst du trotzdem kostenlos durchstöbern).
  • Eine Präsentation in deinem Workspace: Die Session, die du gleich erstellst, führt eine bestehende Präsentation aus.

  1. Erstelle deinen Zugang

    Öffne in deinem Workspace Unternehmen → API und erstelle einen Zugang mit dem Scope content:write. Das Secret wird nur einmal gezeigt: speichere es.

    API-Key holen

    Der Zugang gehört der Organisation, nicht deinem Benutzer: Jeder Admin kann ihn widerrufen, und jede Nutzung landet im Audit-Log. Fordere nur die Scopes an, die du brauchst — results:read zum Lesen, content:write zum Erstellen und Steuern.

  2. Session erstellen und öffnen

    Mit deinem Key im X-API-Key-Header erstellst du eine Session auf einer bestehenden Präsentation und öffnest sie.

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

    Die Session startet in DRAFT; beim Öffnen bekommt sie ihren join_code und der Raum ist bereit. Achte auf die X-RateLimit-*-Header der Antwort: Sie reisen bei jeder Antwort mit und sagen dir, wie viel Request-Budget im 60-Sekunden-Fenster übrig ist.

  3. Ergebnisse empfangen

    Registriere einen Webhook für question.results.finalized und empfange signierte Aggregate in deinem 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"] }'

    Speichere das signing_secret aus der Registrierung: Es wird nur einmal gezeigt und ist das, womit du jede Zustellung verifizierst. Der Webhook-Guide liefert die Verifikation fertig zum Einfügen in drei Sprachen.

Wenn etwas nicht passt

  • 401 — der X-API-Key-Header oder der Scope fehlt: Der Body nennt in required_scope genau welchen.
  • 402 — dein Plan enthält die API nicht: Der Body trägt upgrade_to mit dem Plan, der sie freischaltet.
  • 429 — Budget für dieses Fenster verbraucht: Warte retry_after_seconds und versuche es mit Backoff erneut.

Und jetzt?

Durchstöbere die komplette Referenz, probiere jeden Endpoint online aus und verbinde Zapier oder deinen Agenten über MCP.

API-Referenz →