Com funciona l'API REST de Quick Event?

L'API REST pública de Quick Event permet la creació d'esdeveniments mitjançant sol·licituds HTTP: Punt final: POST /api/public/create-event Autenticació: No cal cap; l'API és d'ús obert. Límit de velocitat: 5 esdeveniments de demostració per adreça IP cada 24 hores. Envieu una descripció (prompt), que opcionalment inclou la data, la ubicació i l'idioma. Quick Event utilitza la IA per generar una pàgina d'esdeveniment completa amb una pàgina de destinació, un formulari de registre, plantilles de correu electrònic i categories d'entrades. La resposta conté enllaços directes a la pàgina de l'esdeveniment i al formulari de registre. Els esdeveniments de demostració caduquen al cap de 30 dies. Amb un compte gratuït, pots fer-te càrrec de l'esdeveniment de manera permanent.

Què és el servidor MCP i com el puc utilitzar?

El **servidor MCP** (Model Context Protocol) fa que Quick Event estigui disponible com a eina en assistents d'IA com Claude Desktop, Cursor i Claude Code: **Endpoint:** https://quick-event.com/api/public/mcp **Transport:** HTTP transmissible (JSON-RPC 2.0 per POST) **Versió del protocol:** 2025-11-25 **Autenticació:** cap L'eina `create_event` accepta els mateixos paràmetres que l'API REST. Els clients MCP no es descobreixen automàticament des d'una URL; has d'afegir l'endpoint a la configuració MCP del client (p. ex., claude_desktop_config.json ), i l'eina estarà disponible en cada nova conversa.

Puc utilitzar Quick Event amb ChatGPT?

**Sí** — mitjançant un GPT personalitzat amb una Acció basada en la nostra especificació OpenAPI 3.1: • **OpenAPI:** https://quick-event.com/.well-known/openapi.yaml Al ChatGPT GPT Builder, crea un nou GPT i afegeix la URL d'OpenAPI a "Accions". L'autenticació es configura com a "Cap". El GPT personalitzat pot crear esdeveniments mitjançant un prompt i distribuir els enllaços generats als usuaris. Nota: la plataforma de plugins de ChatGPT antiga va ser deprecada per OpenAI el 2024; avui només s'admeten els GPT personalitzats / Accions.

Hi ha webhooks disponibles?

Els Webhooks estan **en el full de ruta.** Les característiques planificades són: • Notificacions en temps real per a inscripcions i cancel·lacions • Càrregues útils signades (HMAC-SHA256) per a una verificació segura • Només HTTPS amb lògica de reintent (3× retrocés exponencial) • Filtres d'esdeveniments configurables per URL de webhook La integració de webhook farà possible connectar Quick Event a qualsevol sistema extern — CRM, Slack, els teus propis backends. Envia una sol·licitud de funció a la pàgina del full de ruta per rebre una notificació quan es llanci.

Necessito una clau API o autenticació?

No. L'API pública no requereix autenticació. Qualsevol pot crear un esdeveniment mitjançant una sol·licitud POST. L'única limitació és el límit de freqüència: un màxim de 5 esdeveniments de demostració per adreça IP en 24 hores. Els esdeveniments creats caduquen al cap de 30 dies, tret que es facin permanents registrant un compte gratuït. Totes les connexions són via HTTPS amb TLS 1.3.

Quins serveis de tercers utilitza Quick Event?

Quick Event utilitza els serveis següents en segon pla: • SendGrid: Lliurament de correu electrònic amb compatibilitat amb dominis personalitzats (DKIM, SPF) • Stripe: Processament de pagaments per a entrades i subscripcions de pagament • Pexels: Fotos de stock gratuïtes disponibles directament al creador de pàgines • Cloudflare: Allotjament (Workers), emmagatzematge de fitxers (R2), certificats SSL, dominis personalitzats i CDN Aquests serveis estan totalment integrats: no cal que creeu els vostres propis comptes per utilitzar Quick Event.

Integracions i API

Quick Event es pot integrar en fluxos de treball externs de diverses maneres: un endpoint públic de creació d'esdeveniments, un servidor MCP per a assistents d'IA com Claude Desktop, un manifest OpenAPI per a GPT personalitzats de ChatGPT i una API REST completa planificada per llegir dades d'esdeveniments, participants i reserves. Aquest article descriu les interfícies disponibles i els serveis de tercers que operen en segon pla.

Visió general

Actualment, hi ha dues capes d'integració disponibles: el servidor MCP , que proporciona Quick Event com a eina al Model Context Protocol per a assistents d'IA com Claude Desktop, i una especificació OpenAPI per a la integració amb ChatGPT i altres plataformes compatibles amb OpenAPI. Ambdues interfícies permeten als usuaris crear un esdeveniment complet amb una pàgina de destinació , un formulari de registre , plantilles de correu electrònic i categories de tiquets mitjançant descripcions de text.

API REST Parcial — API de lectura en el full de ruta

Un **endpoint públic de creació d'esdeveniments** ja està actiu avui a POST /api/public/create-event: envia una descripció en llenguatge natural (amb data, ubicació i idioma opcionals) i Quick Event genera un esdeveniment complet — pàgina de destinació, formulari d'inscripció, plantilles de correu electrònic, categories d'entrades — utilitzant IA. No es requereix autenticació; el límit de tarifes és de 5 esdeveniments de demostració per IP cada 24 hores, i els esdeveniments de demostració caduquen després de 30 dies tret que siguin reclamats per un compte gratuït. El mateix endpoint és la base del servidor MCP i la integració amb ChatGPT.

Una **API de lectura completa** per a l'accés programàtic a esdeveniments, participants i reserves està en el full de ruta. Et permetrà integrar Quick Event amb sistemes CRM existents, eines de màrqueting o fluxos de treball interns sense exportacions manuals de dades. Les mutacions autenticades (cancel·lar una reserva, reemborsar una entrada, editar dades del participant) estan planificades juntament amb ella. Els detalls sobre els endpoints, l'autenticació i els formats de dades es proporcionaran amb el llançament.

Servidor MCP

El servidor MCP (Model Context Protocol) fa que Quick Event estigui disponible com a eina en assistents d'IA com Claude Desktop, Cursor, Claude Code i qualsevol altre client compatible amb MCP.

El servidor implementa la versió 2025-11-25 del protocol MCP mitjançant el transport HTTP transmissible a /api/public/mcp (JSON-RPC 2.0, sense autenticació, CORS habilitat). Admet els mètodes initialize, tools/list i tools/call. L'única eina registrada és create_event i accepta els mateixos paràmetres que l'API REST.

A la pràctica: descrius un esdeveniment al teu assistent d'IA, i aquest crida l'eina MCP per crear-lo. Els enllaços generats apareixen en línia a la conversa.

Configuració a Claude Desktop

Els clients MCP no descobreixen servidors automàticament des d'una URL; has d'afegir l'endpoint al fitxer de configuració del client. A Claude Desktop, edita claude_desktop_config.json (Configuració → Desenvolupador → Edita configuració) i afegeix un servidor MCP remot que apunti a https://quick-event.com/api/public/mcp. Reinicia Claude Desktop i l'eina create_event estarà disponible en noves converses. Cursor, Claude Code i altres clients utilitzen un patró de fitxer de configuració similar. També es publica un resum llegible per màquina del servidor (nom, endpoint, esquemes d'eines) a /.well-known/mcp.json per a la documentació i les eines que el vulguin llegir.

Integració amb ChatGPT

Quick Event publica una **especificació OpenAPI 3.1** a /.well-known/openapi.yaml per utilitzar-la com a Acció de GPT personalitzat de ChatGPT.

Al ChatGPT GPT Builder, crea un nou GPT, obre **Configura → Accions** i importa la URL d'OpenAPI. El camp d'autenticació es manté a "Cap". El GPT personalitzat pot crear esdeveniments a partir d'un prompt i mostrar els enllaços retornats a l'usuari. L'especificació OpenAPI documenta l'endpoint completament: esquema de sol·licitud, exemples de resposta i codis d'error.

La plataforma de plugins de ChatGPT antiga (amb el seu manifest ai-plugin.json) va ser deprecada per OpenAI el 2024 i ja no s'admet; els GPT personalitzats amb Accions OpenAPI són el camí actual.

Webhooks Planificat

Els Webhooks estan **en el full de ruta.** Faran possible enviar automàticament sol·licituds HTTP a una URL configurable en resposta a certs esdeveniments — com una nova inscripció, una cancel·lació o un canvi d'estat.

L'arquitectura planificada inclou càrregues útils signades (HMAC-SHA256), lliurament només per HTTPS i lògica de reintent amb tres intents i retrocés exponencial. Els filtres d'esdeveniments permetran subscriure's només a tipus d'esdeveniments específics per URL de webhook.

Un cop els webhooks estiguin disponibles, permetran fluxos de treball com notificacions de Slack per a noves inscripcions, sincronització de CRM o correus electrònics de seguiment automàtics mitjançant sistemes externs. Vols rebre una notificació quan això es llanci? Envia una sol·licitud a la pàgina del full de ruta.

Serveis de tercers

Quick Event utilitza diversos serveis especialitzats en segon pla. Com a usuari, no necessites crear un compte separat amb cap d'aquests proveïdors — la integració està totalment incrustada a la plataforma.

SendGrid (Correu electrònic)

Tots els correus electrònics transaccionals —confirmacions de registre, recordatoris, correus electrònics de campanya— s'envien mitjançant SendGrid. Quick Event configura automàticament els registres DKIM i SPF per a dominis personalitzats , assegurant que els correus electrònics s'envien des de la teva pròpia adreça de remitent i aconsegueixen una alta taxa de lliurament .

Stripe (Pagaments)

Les entrades de pagament es processen mitjançant Stripe Connect — els fons es dirigeixen directament al compte bancari de l'organitzador, mai retinguts per Quick Event. L'Studio t'incorpora a Stripe Connect en el primer esdeveniment de pagament, mostra l'estat chargesEnabled i payoutsEnabled, i gestiona automàticament els reemborsaments i les factures conformes amb l'IVA. Targeta, Apple Pay, Google Pay, SEPA i altres mètodes de pagament locals són compatibles de sèrie. La tarifa per entrada de Quick Event (€0.99 + 2.75 %) es dedueix de cada pagament de Stripe — consulta Entrades de pagament per al flux complet.

Pexels (fotos d'arxiu)

El constructor de pàgines inclou una cerca d'imatges integrada mitjançant l'API de Pexels. Pots triar entre milions de fotos gratuïtes i lliures de drets d'autor directament en crear una pàgina d'esdeveniment i integrar-les a la teva pàgina —sense cap descàrrega o càrrega separada.

Cloudflare (Infraestructura)

Tota la plataforma funciona amb Cloudflare Workers. Els fitxers (logotips, PDF, imatges) s'emmagatzemen a Cloudflare R2. Els dominis personalitzats reben automàticament certificats SSL mitjançant Cloudflare for SaaS. La CDN global garanteix temps de càrrega ràpids independentment de la ubicació dels participants.