Hoe werkt Quick Event's REST API?

Quick Event's publieke REST API maakt evenementcreatie mogelijk via HTTP-verzoek: Eindpunt: POST /api/public/create-event Authenticatie: Niet vereist — de API is openbaar bruikbaar. Snelheidslimiet: 5 demo-evenementen per IP-adres per 24 uur. Je stuurt een beschrijving (prompt), optioneel inclusief datum, locatie en taal. Quick Event gebruikt AI om een complete evenementpagina te genereren met een landingspagina, registratieformulier, e-mailsjablonen en ticketcategorieën. De respons bevat directe links naar de evenementpagina en het registratieformulier. Demo-evenementen verlopen na 30 dagen. Met een gratis account kun je het evenement permanent overnemen.

Wat is de MCP-server en hoe gebruik ik deze?

De MCP Server (Model Context Protocol) maakt Quick Event beschikbaar als tool in AI-assistenten zoals Claude Desktop, Cursor en Claude Code: Eindpunt: https://quick-event.com/api/public/mcp Transport: Streamable HTTP (JSON-RPC 2.0 over POST) Protocolversie: 2025-11-25 Authenticatie: geen De `create_event` tool accepteert dezelfde parameters als de REST API. MCP-clients worden niet automatisch ontdekt via een URL — je voegt het eindpunt toe aan de MCP-configuratie van de client (bijv. claude_desktop_config.json ), en de tool wordt beschikbaar in elk nieuw gesprek.

Kan ik Quick Event gebruiken met ChatGPT?

Ja — via een aangepaste GPT met een actie ondersteund door onze OpenAPI 3.1 specificatie: • OpenAPI: https://quick-event.com/.well-known/openapi.yaml In de ChatGPT GPT Builder creëer je een nieuwe GPT en voeg je de OpenAPI URL toe onder "Acties". Authenticatie is ingesteld op "Geen". De aangepaste GPT kan dan evenementen creëren via prompt en de gegenereerde links distribueren naar gebruikers. Opmerking: het verouderde ChatGPT Plugins platform is in 2024 door OpenAI afgeschreven — alleen Custom GPT's / Acties worden vandaag ondersteund.

Zijn webhooks beschikbaar?

Webhooks staan **op de roadmap.** De geplande functies zijn: • Realtime meldingen voor registraties en annuleringen • Ondertekende payloads (HMAC-SHA256) voor veilige verificatie • Alleen HTTPS met herhaallogica (3× exponentiële backoff) • Configureerbare eventfilters per webhook-URL De webhook-integratie maakt het mogelijk om Quick Event te verbinden met elk extern systeem — CRM, Slack, je eigen backends. Dien een featureverzoek in op de roadmap-pagina om op de hoogte te worden gebracht wanneer het beschikbaar is.

Heb ik een API-sleutel of authenticatie nodig?

**Nee.** De openbare API vereist geen authenticatie. Iedereen kan een evenement aanmaken via een POST-verzoek. De enige beperking is de rate limit: maximaal 5 demo-evenementen per IP-adres binnen 24 uur. Aangemaakte evenementen verlopen na 30 dagen, tenzij ze permanent worden gemaakt door een gratis account te registreren. Alle verbindingen zijn via HTTPS met TLS 1.3.

Welke externe diensten gebruikt Quick Event?

Quick Event gebruikt de volgende diensten op de achtergrond: • **SendGrid:** E-maillevering met ondersteuning voor aangepaste domeinen (DKIM, SPF) • **Stripe:** Betalingsverwerking voor betaalde tickets en abonnementen • **Pexels:** Gratis stockfoto's direct beschikbaar in de page builder • **Cloudflare:** Hosting (Workers), bestandsopslag (R2), SSL-certificaten, aangepaste domeinen en CDN Deze diensten zijn volledig geïntegreerd — je hoeft geen eigen accounts aan te maken om Quick Event te gebruiken.

Integraties & API

Quick Event kan op verschillende manieren worden geïntegreerd in externe workflows — een openbaar endpoint voor het aanmaken van evenementen, een MCP-server voor AI-assistenten zoals Claude Desktop, een OpenAPI-manifest voor ChatGPT custom GPT's, en een geplande volledige REST API voor het lezen van event-, deelnemer- en boekingsgegevens. Dit artikel beschrijft de beschikbare interfaces en de externe diensten die op de achtergrond werken.

Overzicht

Momenteel zijn er twee integratielagen beschikbaar: de MCP-server, die Quick Event aanbiedt als tool in het Model Context Protocol voor AI-assistenten zoals Claude Desktop, en een OpenAPI-specificatie voor integratie met ChatGPT en andere OpenAPI-compatibele platforms. Beide interfaces stellen gebruikers in staat om een compleet evenement te creëren met een landingspagina, een registratieformulier, e-mailsjablonen en ticketcategorieën met behulp van tekstbeschrijvingen.

REST API Gedeeltelijk — lees-API op roadmap

Een openbaar endpoint voor het aanmaken van evenementen is vandaag live op POST /api/public/create-event: stuur een beschrijving in natuurlijke taal (met optionele datum, locatie en taal) en Quick Event genereert een compleet evenement — landingspagina, registratieformulier, e-mailsjablonen, ticketcategorieën — met behulp van AI. Geen authenticatie vereist; de rate limit is 5 demo-evenementen per IP per 24 uur, en demo-evenementen verlopen na 30 dagen, tenzij ze worden geclaimd door een gratis account. Hetzelfde endpoint ondersteunt de MCP-server en de ChatGPT-integratie.

Een volledige lees-API voor programmatische toegang tot evenementen, deelnemers en boekingen staat op de roadmap. Hiermee kun je Quick Event integreren met bestaande CRM-systemen, marketingtools of interne workflows zonder handmatige data-exports. Geauthenticeerde mutaties (een boeking annuleren, een ticket terugbetalen, deelnemersgegevens bewerken) zijn ernaast gepland. Details over endpoints, authenticatie en dataformaten volgen bij de release.

MCP-server

De MCP (Model Context Protocol) server maakt Quick Event beschikbaar als tool in AI-assistenten zoals Claude Desktop, Cursor, Claude Code en elke andere MCP-compatibele client.

De server implementeert MCP-protocolversie 2025-11-25 via het Streamable HTTP-transport op /api/public/mcp (JSON-RPC 2.0, geen authenticatie, CORS ingeschakeld). Het ondersteunt de methoden initialize, tools/list en tools/call. De enige geregistreerde tool is create_event en deze accepteert dezelfde parameters als de REST API.

In de praktijk: je beschrijft een evenement aan je AI-assistent, en deze roept de MCP-tool aan om het aan te maken. De gegenereerde links verschijnen inline in het gesprek.

Installatie in Claude Desktop

MCP-clients ontdekken servers *niet* automatisch via een URL — je voegt het endpoint toe aan het configuratiebestand van de client. In Claude Desktop bewerk je claude_desktop_config.json (Instellingen → Ontwikkelaar → Config bewerken) en voeg je een externe MCP-server toe die verwijst naar https://quick-event.com/api/public/mcp. Herstart Claude Desktop en de create_event tool wordt beschikbaar in nieuwe gesprekken. Cursor, Claude Code en andere clients gebruiken een vergelijkbaar configuratiebestandspatroon. Een machineleesbare samenvatting van de server (naam, endpoint, tool-schema's) wordt ook gepubliceerd op /.well-known/mcp.json voor documentatie en tooling die het wil lezen.

ChatGPT-integratie

Quick Event publiceert een **OpenAPI 3.1-specificatie** op /.well-known/openapi.yaml voor gebruik als een ChatGPT custom-GPT Actie.

In de ChatGPT GPT Builder maak je een nieuwe GPT aan, open je **Configureren → Acties**, en importeer je de OpenAPI-URL. Het authenticatieveld blijft op "Geen" staan. De custom GPT kan vervolgens evenementen aanmaken op basis van een prompt en de geretourneerde links aan de gebruiker tonen. De OpenAPI-specificatie documenteert het endpoint volledig — verzoekschema, voorbeelden van antwoorden en foutcodes.

Het verouderde ChatGPT Plugins-platform (met zijn ai-plugin.json manifest) is in 2024 door OpenAI afgeschreven en wordt niet langer ondersteund — Custom GPT's met OpenAPI-acties zijn de huidige weg.

Webhooks Gepland

Webhooks staan **op de roadmap.** Ze maken het mogelijk om automatisch HTTP-verzoeken te sturen naar een configureerbare URL als reactie op bepaalde evenementen — zoals een nieuwe registratie, een annulering of een statuswijziging.

De geplande architectuur omvat ondertekende payloads (HMAC-SHA256), alleen HTTPS-levering en herhaallogica met drie pogingen en exponentiële backoff. Eventfilters maken het mogelijk om je alleen te abonneren op specifieke eventtypes per webhook-URL.

Zodra webhooks beschikbaar zijn, maken ze workflows mogelijk zoals Slack-meldingen voor nieuwe registraties, CRM-synchronisatie of automatische follow-up e-mails via externe systemen. Wil je op de hoogte worden gebracht wanneer dit beschikbaar is? Dien een verzoek in op de roadmap-pagina.

Diensten van derden

Quick Event maakt op de achtergrond gebruik van verschillende gespecialiseerde diensten. Als gebruiker hoef je geen apart account aan te maken bij een van deze providers — de integratie is volledig ingebed in het platform.

SendGrid (E-mail)

Alle transactionele e-mails — registratiebevestigingen, herinneringen, campagne-e-mails — worden via SendGrid geleverd. Quick Event configureert automatisch DKIM- en SPF-records voor aangepaste domeinen, zodat e-mails vanaf je eigen afzenderadres worden verzonden en een hoog afleveringspercentage behalen.

Stripe (Betalingen)

Betaalde tickets worden verwerkt via Stripe Connect — gelden worden direct naar de bankrekening van de organisator geleid, en nooit door Quick Event vastgehouden. De Studio begeleidt je bij je eerste betaalde evenement naar Stripe Connect, toont de status van chargesEnabled en payoutsEnabled, en verwerkt restituties en btw-conforme facturen automatisch. Kaart, Apple Pay, Google Pay, SEPA en andere lokale betaalmethoden worden standaard ondersteund. De per-ticket vergoeding van Quick Event (€0,99 + 2,75 %) wordt van elke Stripe-uitbetaling afgetrokken — zie Betaalde tickets voor de volledige procedure.

Pexels (stockfoto's)

De paginabouwer bevat een geïntegreerde zoekfunctie voor afbeeldingen via de Pexels API. Je kunt direct bij het maken van een evenementpagina kiezen uit miljoenen gratis, royaltyvrije foto's en deze in je pagina integreren — zonder aparte download of upload.

Cloudflare (Infrastructuur)

Het hele platform draait op Cloudflare Workers. Bestanden (logo's, PDF's, afbeeldingen) worden opgeslagen in Cloudflare R2. Aangepaste domeinen ontvangen automatisch SSL-certificaten via Cloudflare for SaaS. Het wereldwijde CDN zorgt voor snelle laadtijden, ongeacht de locatie van de deelnemers.