Skip to content

Winglark

Beginnen Sie hier

API & Webhooks

In Betrieb

Eine Eventmanagement-API mit signierten Webhooks.

Lesen Sie Veranstaltungen, Gäste, Rückmeldungen und Check-ins, legen Sie Gäste aus Ihren eigenen Systemen an und ändern Sie sie — und erhalten Sie eine signierte Nachricht, sobald auf der Veranstaltung etwas passiert.

Zugang anfragenEntwicklerreferenz öffnen
  • REST-API v1
  • Dreizehn Webhook-Ereignisse
  • Professional und Agency
Ein rsvp.submitted-Webhook, wie Ihr Endpunkt ihn empfängt
POST /winglark HTTP/1.1
Winglark-Signature: t=1762338012,v1=5f2b…c9e1
Winglark-Event: rsvp.submitted
Winglark-Delivery: 7c1e9a42-…

{
  "type": "rsvp.submitted",
  "created_at": "2026-11-05T18:40:12.481Z",
  "event_id": "6f1c2a7e-…",
  "data": {
    "response": "yes",
    "party_size": 2,
    "guest": { "first_name": "Ada", "email": "a•••@example.com" }
  }
}

Kontaktdaten bleiben maskiert, sofern der Endpunkt sie nicht sehen darf.

Was sie leistet

Ihre Systeme, von der Veranstaltung selbst aktuell gehalten.

Alles hier funktioniert heute in den Tarifen Professional und Agency.

Die Veranstaltung lesen
Veranstaltungen, Gäste, Rückmeldungen und Check-ins, per Cursor paginiert, damit eine große Liste in Teilen kommt.
Die Liste schreiben
Gäste aus Ticketseite, CRM oder Formular anlegen oder ändern. Ein Idempotenzschlüssel macht eine Wiederholung harmlos.
Hören, wenn es passiert
Webhooks für Rückmeldungen, Einladungen, den Einlass, Tickets, Sitzplan und Namensschilder, mit Zeitstempel signiert.
Jede Zustellung sehen
Ein Protokoll mit Status und Versuch, erneutes Senden, ein Testereignis und pausierte fehlerhafte Endpunkte.

So funktioniert es

Drei Schritte.

  1. Einen Schlüssel erstellenUnter Integrationen die Berechtigungen und auf Wunsch ein Ablaufdatum wählen. Kopieren: Er wird nur einmal gezeigt.
  2. Einen Endpunkt hinzufügenHTTPS-Adresse und die Ereignisse angeben, die er hören soll. Ein Testereignis prüft die Signatur.
  3. Darauf aufbauenDie API mit dem Schlüssel aufrufen und auf jeden Webhook reagieren. Die Entwicklerreferenz nennt jede Route und jedes Feld.

Im Produkt

Schlüssel, Webhooks und jede Zustellung auf einem Bildschirm.

Integrationen liegen in den Workspace-Einstellungen. Ein Schlüssel wird mit den nötigen Berechtigungen erstellt und einmal gezeigt; ein Endpunkt bekommt die Ereignisse, die er hören soll; das Zustellprotokoll zeigt, was gesendet wurde, was zurückkam und was erneut versucht wird.

Beispielhafter Workspace, Schlüssel und Zustellungen. Die Bildschirme sind dem Produkt nachgezeichnet, wie es arbeitet.

API & WebhooksIn Betrieb

Was Sie brauchen

Einen Workspace im Tarif Professional oder Agency und jemanden, der eine HTTPS-Anfrage entgegennehmen kann. Free, Starter und Single Event enthalten die API nicht.

Entwicklerreferenz öffnen →Integrationen →Tarife vergleichen →

Die Ereignisse, die ein Endpunkt abonnieren kann

  • guest.created
  • guest.updated
  • guest.archived
  • rsvp.submitted
  • invitation.sent
  • invitation.delivered
  • invitation.bounced
  • checkin.admitted
  • ticket.issued
  • event.published
  • event.cancelled
  • seatmap.published
  • badge.printed

Fragen

Gibt es eine REST-API für Gästelisten von Veranstaltungen?

Ja: Gäste je Veranstaltung auflisten, lesen, anlegen und ändern sowie Rückmeldungen und Check-ins lesen. Antworten sind JSON, Listen nutzen Cursor-Paginierung, und das Anlegen akzeptiert einen Idempotenzschlüssel.

Wie werden Webhooks signiert?

Mit einem HMAC über Zeitstempel und unveränderten Inhalt, gesendet im Header Winglark-Signature. Beim Rotieren des Geheimnisses bleibt das alte eine Übergangszeit lang gültig, sodass beim Wechsel nichts verloren geht.

Gibt es Ratenbegrenzungen?

Ja, je Schlüssel. Eine Anfrage über dem Limit wird mit Status 429 beantwortet und kann nach der in der Antwort genannten Wartezeit wiederholt werden.

Lässt sich ein Schlüssel auf Lesen beschränken?

Ja. Ein Schlüssel trägt nur die Berechtigungen, mit denen er erstellt wurde — etwa Veranstaltungen und Rückmeldungen lesen und nichts schreiben.

Geben Sie Ihren Systemen einen Schlüssel.

In Professional und Agency, in den Workspace-Einstellungen.

Zugang anfragenEntwicklerreferenz öffnen