Wie funktioniert die REST API von Quick Event?

Die **öffentliche REST API** von Quick Event ermöglicht die Event-Erstellung per HTTP-Anfrage: **Endpoint:** POST /api/public/create-event **Authentifizierung:** Keine erforderlich – die API ist offen nutzbar. **Rate Limit:** 5 Demo-Events pro IP-Adresse pro 24 Stunden. Du sendest eine Beschreibung (Prompt), optional inklusive Datum, Ort und Sprache. Quick Event generiert mittels KI eine komplette Event-Seite mit Landingpage, Registrierungsformular, E-Mail-Vorlagen und Ticketkategorien. Die Antwort enthält direkte Links zur Event-Seite und zum Registrierungsformular. Demo-Events verfallen nach 30 Tagen. Mit einem kostenlosen Account kannst du das Event dauerhaft übernehmen.

Was ist der MCP Server und wie nutze ich ihn?

Der **MCP-Server** (Model Context Protocol) macht Quick Event als Tool in KI-Assistenten wie Claude Desktop, Cursor und Claude Code verfügbar: **Endpunkt:** https://quick-event.com/api/public/mcp **Transport:** Streamable HTTP (JSON-RPC 2.0 über POST) **Protokollversion:** 2025-11-25 **Authentifizierung:** keine Das `create_event`-Tool akzeptiert dieselben Parameter wie die REST-API. MCP-Clients werden nicht automatisch über eine URL erkannt – du fügst den Endpunkt zur MCP-Konfiguration des Clients hinzu (z. B. claude_desktop_config.json ), und das Tool wird in jeder neuen Konversation verfügbar.

Kann ich Quick Event mit ChatGPT nutzen?

**Ja** – über ein benutzerdefiniertes GPT mit einer Aktion, die auf unserer OpenAPI 3.1 Spezifikation basiert: • **OpenAPI:** https://quick-event.com/.well-known/openapi.yaml Im ChatGPT GPT Builder erstellst du ein neues GPT und fügst die OpenAPI-URL unter „Aktionen“ hinzu. Die Authentifizierung ist auf „Keine“ eingestellt. Das benutzerdefinierte GPT kann dann Events per Prompt erstellen und die generierten Links an Benutzer verteilen. Hinweis: Die ältere ChatGPT Plugins-Plattform wurde 2024 von OpenAI eingestellt – heute werden nur noch benutzerdefinierte GPTs / Aktionen unterstützt.

Sind Webhooks verfügbar?

Webhooks sind **auf der Roadmap.** Die geplanten Funktionen sind: • Echtzeit-Benachrichtigungen für Anmeldungen und Stornierungen • Signierte Payloads (HMAC-SHA256) für sichere Verifizierung • Nur HTTPS mit Wiederholungslogik (3× exponentieller Backoff) • Konfigurierbare Event-Filter pro Webhook-URL Die Webhook-Integration wird es ermöglichen, Quick Event mit jedem externen System zu verbinden – CRM, Slack, deine eigenen Backends. Reiche einen Feature-Wunsch auf der Roadmap-Seite ein, um benachrichtigt zu werden, wenn es veröffentlicht wird.

Brauche ich einen API-Schlüssel oder eine Authentifizierung?

**Nein.** Die öffentliche API erfordert keine Authentifizierung. Jeder kann ein Event per POST-Anfrage erstellen. Die einzige Einschränkung ist das Rate Limit: maximal 5 Demo-Events pro IP-Adresse innerhalb von 24 Stunden. Erstellte Events verfallen nach 30 Tagen, es sei denn, sie werden durch die Registrierung eines kostenlosen Accounts dauerhaft gemacht. Alle Verbindungen erfolgen über HTTPS mit TLS 1.3.

Welche Drittanbieter-Dienste nutzt Quick Event?

Quick Event nutzt im Hintergrund die folgenden Dienste: • SendGrid: E-Mail-Zustellung mit Unterstützung für benutzerdefinierte Domains (DKIM, SPF) • Stripe: Zahlungsabwicklung für kostenpflichtige Tickets und Abonnements • Pexels: Kostenlose Stockfotos direkt im Page Builder verfügbar • Cloudflare: Hosting (Workers), Dateispeicher (R2), SSL-Zertifikate, benutzerdefinierte Domains und CDN Diese Dienste sind vollständig integriert – du musst keine eigenen Konten erstellen, um Quick Event zu nutzen.

Integrationen & API

Quick Event kann auf verschiedene Weisen in externe Workflows integriert werden – über einen öffentlichen Endpunkt zur Event-Erstellung, einen MCP-Server für KI-Assistenten wie Claude Desktop, ein OpenAPI-Manifest für benutzerdefinierte ChatGPT GPTs und eine geplante vollständige REST-API zum Lesen von Event-, Teilnehmer- und Buchungsdaten. Dieser Artikel beschreibt die verfügbaren Schnittstellen und die Drittanbieterdienste, die im Hintergrund arbeiten.

Übersicht

Aktuell stehen zwei Integrationsebenen zur Verfügung: Der MCP Server , der Quick Event als Tool im Model Context Protocol für KI-Assistenten wie Claude Desktop bereitstellt, und eine OpenAPI-Spezifikation zur Integration mit ChatGPT und anderen OpenAPI-kompatiblen Plattformen. Beide Schnittstellen ermöglichen es Nutzern, ein vollständiges Event mit einer Landingpage , Registrierungsformular , E-Mail-Vorlagen und Ticketkategorien mithilfe von Textbeschreibungen zu erstellen.

REST API Teilweise – Lese-API auf der Roadmap

Ein öffentlicher Endpunkt zur Event-Erstellung ist heute unter POST /api/public/create-event live: Sende eine natürlichsprachliche Beschreibung (mit optionalem Datum, Ort und Sprache) und Quick Event generiert ein vollständiges Event – Landingpage, Anmeldeformular, E-Mail-Vorlagen, Ticketkategorien – mithilfe von KI. Keine Authentifizierung erforderlich; das Ratenlimit beträgt 5 Demo-Events pro IP innerhalb von 24 Stunden, und Demo-Events verfallen nach 30 Tagen, es sei denn, sie werden von einem kostenlosen Konto beansprucht. Derselbe Endpunkt unterstützt den MCP-Server und die ChatGPT-Integration .

Eine vollständige Lese-API für den programmatischen Zugriff auf Events, Teilnehmer und Buchungen ist auf der Roadmap. Sie wird es dir ermöglichen, Quick Event ohne manuelle Datenexporte in bestehende CRM-Systeme, Marketing-Tools oder interne Workflows zu integrieren. Authentifizierte Mutationen (eine Buchung stornieren, ein Ticket erstatten, Teilnehmerdaten bearbeiten) sind parallel dazu geplant. Details zu Endpunkten, Authentifizierung und Datenformaten folgen mit der Veröffentlichung.

MCP-Server

Der MCP-Server (Model Context Protocol) macht Quick Event als Tool in KI-Assistenten wie Claude Desktop, Cursor, Claude Code und jedem anderen MCP-kompatiblen Client verfügbar.

Der Server implementiert die MCP-Protokollversion 2025-11-25 über den Streamable HTTP-Transport unter /api/public/mcp (JSON-RPC 2.0, keine Authentifizierung, CORS aktiviert). Er unterstützt die Methoden initialize, tools/list und tools/call. Das einzige registrierte Tool ist create_event und es akzeptiert dieselben Parameter wie die REST-API.

In der Praxis: Du beschreibst deinem KI-Assistenten ein Event, und dieser ruft das MCP-Tool auf, um es zu erstellen. Die generierten Links erscheinen direkt in der Konversation.

Einrichtung in Claude Desktop

MCP-Clients erkennen Server nicht automatisch über eine URL – du fügst den Endpunkt zur Konfigurationsdatei des Clients hinzu. In Claude Desktop bearbeitest du claude_desktop_config.json (Einstellungen → Entwickler → Konfiguration bearbeiten) und fügst einen Remote-MCP-Server hinzu, der auf https://quick-event.com/api/public/mcp verweist. Starte Claude Desktop neu, und das create_event-Tool wird in neuen Konversationen verfügbar. Cursor, Claude Code und andere Clients verwenden ein ähnliches Konfigurationsdateimuster. Eine maschinenlesbare Zusammenfassung des Servers (Name, Endpunkt, Tool-Schemas) wird auch unter /.well-known/mcp.json für Dokumentation und Tools, die sie lesen möchten, veröffentlicht.

ChatGPT Integration

Quick Event veröffentlicht eine OpenAPI 3.1 Spezifikation unter /.well-known/openapi.yaml zur Verwendung als ChatGPT benutzerdefinierte GPT-Aktion.

Im ChatGPT GPT Builder erstellst du ein neues GPT, öffnest Konfigurieren → Aktionen und importierst die OpenAPI-URL. Das Authentifizierungsfeld bleibt auf „Keine“. Das benutzerdefinierte GPT kann dann Events aus einem Prompt erstellen und die zurückgegebenen Links dem Benutzer anzeigen. Die OpenAPI-Spezifikation dokumentiert den Endpunkt vollständig – Anforderungsschema, Antwortbeispiele und Fehlercodes.

Die ältere ChatGPT Plugins-Plattform (mit ihrem ai-plugin.json Manifest) wurde 2024 von OpenAI eingestellt und wird nicht mehr unterstützt – benutzerdefinierte GPTs mit OpenAPI-Aktionen sind der aktuelle Weg.

Webhooks Geplant

Webhooks sind **auf der Roadmap.** Sie werden es ermöglichen, automatisch HTTP-Anfragen an eine konfigurierbare URL als Reaktion auf bestimmte Events zu senden – wie eine neue Anmeldung, eine Stornierung oder eine Statusänderung.

Die geplante Architektur umfasst signierte Payloads (HMAC-SHA256), eine reine HTTPS-Bereitstellung und eine Wiederholungslogik mit drei Versuchen und exponentiellem Backoff. Event-Filter werden es ermöglichen, nur bestimmte Event-Typen pro Webhook-URL zu abonnieren.

Sobald Webhooks verfügbar sind, werden sie Workflows wie Slack-Benachrichtigungen für neue Anmeldungen, CRM-Synchronisation oder automatische Follow-up-E-Mails über externe Systeme ermöglichen. Möchtest du benachrichtigt werden, wenn dies veröffentlicht wird? Reiche eine Anfrage auf der Roadmap-Seite ein.

Dienste von Drittanbietern

Quick Event nutzt im Hintergrund mehrere spezialisierte Dienste. Als Nutzer musst du bei keinem dieser Anbieter ein separates Konto erstellen – die Integration ist vollständig in die Plattform eingebettet.

SendGrid (E-Mail)

Alle transaktionalen E-Mails – Registrierungsbestätigungen, Erinnerungen, Kampagnen-E-Mails – werden über SendGrid zugestellt. Quick Event konfiguriert automatisch DKIM- und SPF-Einträge für benutzerdefinierte Domains, um sicherzustellen, dass E-Mails von deiner eigenen Absenderadresse gesendet werden und eine hohe Zustellrate erzielen.

Stripe (Zahlungen)

Bezahlte Tickets werden über Stripe Connect abgewickelt – Gelder werden direkt auf das Bankkonto des Veranstalters geleitet und niemals von Quick Event einbehalten. Das Studio führt dich beim ersten kostenpflichtigen Event in Stripe Connect ein, zeigt den Status von chargesEnabled und payoutsEnabled an und wickelt Rückerstattungen sowie umsatzsteuerkonforme Rechnungen automatisch ab. Kreditkarte, Apple Pay, Google Pay, SEPA und andere lokale Zahlungsmethoden werden sofort unterstützt. Die Pro-Ticket-Gebühr von Quick Event (€0,99 + 2,75 %) wird von jeder Stripe-Auszahlung abgezogen – den vollständigen Ablauf findest du unter Bezahlte Tickets.

Pexels (Stockfotos)

Der Page Builder beinhaltet eine integrierte Bildersuche über die Pexels API. Du kannst direkt beim Erstellen einer Event-Seite aus Millionen von kostenlosen, lizenzfreien Fotos wählen und diese in deine Seite integrieren – ohne separaten Download oder Upload.

Cloudflare (Infrastruktur)

Die gesamte Plattform läuft auf Cloudflare Workers. Dateien (Logos, PDFs, Bilder) werden in Cloudflare R2 gespeichert. Benutzerdefinierte Domains erhalten automatisch SSL-Zertifikate über Cloudflare for SaaS. Das globale CDN sorgt für schnelle Ladezeiten, unabhängig vom Standort der Teilnehmer.