Live-Umfragen mit der PollsLive-API in dein Produkt einbinden

Wenn dein Produkt ein Publikum hat – ein Webinar-Tool, ein LMS, eine Community-Plattform, eine Event-App – willst du früher oder später Umfragen darin. Echtzeit-Abstimmung, Betrugsschutz und eine Ergebnisoberfläche von Grund auf zu bauen, sind Monate an Arbeit. PollsLive zu integrieren, ist ein Nachmittag. Hier ist der Entwicklerweg: Umfrage erstellen, Embed einfügen, Ergebnisse lesen und Webhooks empfangen, mit echten Aufrufen an /api/v1.

Authentifizierung: ein einziger Bearer-Token

Erzeuge einen Workspace-API-Schlüssel unter Studio → Developers (sie sehen aus wie `plv_live_…`) und sende ihn als Bearer-Token. Kein OAuth-Tanz für die Server-zu-Server-Nutzung; OAuth-Client-Credentials sind verfügbar, wenn du mandantenbezogenen Scope brauchst.

export POLLSLIVE_API=https://pollslive.com/api/v1
export POLLSLIVE_KEY=plv_live_xxxxxxxxxxxxxxxxxxxx

# Every request carries the key as a Bearer token:
#   Authorization: Bearer $POLLSLIVE_KEY
# Rate limit: 120 requests/min per key (HTTP 429 if exceeded).

Schritt 1 – Erstelle eine Umfrage aus deinem Code

Eine Umfrage ist ein typisiertes Deck: content.questions ist ein Array von Folien, jede mit einem kind-Diskriminator. POST /polls gibt die neue Umfrage zurück, samt ihres Slugs, der alles ist, was du zum Einbetten brauchst.

curl -sS -X POST "$POLLSLIVE_API/polls" \
  -H "Authorization: Bearer $POLLSLIVE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Which feature should we build next?",
    "renderingMode": "ASYNC",
    "content": {
      "questions": [{
        "id": "next",
        "kind": "multiple_choice",
        "text": "Which feature should we build next?",
        "options": [
          { "id": "a", "label": "Dark mode" },
          { "id": "b", "label": "Mobile app" },
          { "id": "c", "label": "Public API" }
        ]
      }]
    }
  }'
# → { "poll": { "slug": "which-feature-x7f2", ... } }

Schritt 2 – Bette sie in deine Oberfläche ein

Platziere die Umfrage auf jeder beliebigen Seite mit einem einzeiligen iframe: kein SDK, keine Client-Bibliothek und keine Drittanbieter-Tracker, die mitreisen. Sie passt sich ihrem Container an und funktioniert in React, WordPress, Webflow oder reinem HTML.

<iframe
  src="https://pollslive.com/embed/which-feature-x7f2"
  width="100%" height="520"
  style="border:0;border-radius:12px"
  loading="lazy" title="PollsLive poll"></iframe>

Schritt 3 – Lies die Ergebnisse aus, wann immer du sie brauchst

Hole die Zählungen bei Bedarf für deine eigenen Dashboards ab oder exportiere eine CSV für Berichte. Die Ergebnisse kommen pro Folie zurück, mit Zählungen und (bei Skalen) Durchschnittswerten.

curl -sS "$POLLSLIVE_API/polls/POLL_ID/results" \
  -H "Authorization: Bearer $POLLSLIVE_KEY"
# → { "questions": [ { "id": "next", "options": [
#       { "id": "a", "label": "Dark mode",  "count": 64 },
#       { "id": "b", "label": "Mobile app", "count": 41 },
#       { "id": "c", "label": "Public API", "count": 95 } ] } ] }

Schritt 4 – Empfange Updates per Webhook

Die API abzufragen funktioniert, aber Webhooks sind besser. Registriere einen Endpoint, und PollsLive sendet HMAC-signierte Events – vote.created, poll.published, session.started/ended –, damit deine App in Echtzeit reagiert. Prüfe die Signatur und aktualisiere dann deine Oberfläche oder leite das Event weiter.

import crypto from "node:crypto";

export function verify(rawBody, signature, secret) {
  const expected = crypto
    .createHmac("sha256", secret)
    .update(rawBody)
    .digest("hex");
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

Das ist der gesamte Zyklus: erstellen, einbetten, lesen, reagieren. Für die vollständige Referenz – jeden Endpoint, Scope und Event-Typ – sieh dir die Entwicklerdokumentation an, und für ein praktisches Beispiel Live-Ergebnisse mit Webhooks auf ein internes Dashboard bringen.