Comment fonctionne l'API REST de Quick Event ?

L'API REST publique de Quick Event permet la création d'événements via une requête HTTP : Point de terminaison : POST /api/public/create-event Authentification : Aucune requise — l’API est librement utilisable. Limite de débit : 5 événements de démonstration par adresse IP et par période de 24 heures. Vous envoyez une description (invite), incluant éventuellement la date, le lieu et la langue. Quick Event utilise l'IA pour générer une page événement complète avec une page d'accueil, un formulaire d'inscription, des modèles d'e-mails et des catégories de billets. La réponse contient des liens directs vers la page événement et le formulaire d'inscription. Les événements de démonstration expirent après 30 jours. Avec un compte gratuit, vous pouvez prendre le contrôle de l'événement définitivement.

Qu'est-ce que le serveur MCP et comment l'utiliser ?

Le **serveur MCP** (Model Context Protocol) rend Quick Event disponible en tant qu'outil dans les assistants IA comme Claude Desktop, Cursor et Claude Code : **Point d'accès :** https://quick-event.com/api/public/mcp **Transport :** HTTP streamable (JSON-RPC 2.0 via POST) **Version du protocole :** 2025-11-25 **Authentification :** aucune L'outil `create_event` accepte les mêmes paramètres que l'API REST. Les clients MCP ne sont pas auto-découverts à partir d'une URL — tu ajoutes le point d'accès à la configuration MCP du client (par exemple, claude_desktop_config.json ), et l'outil devient disponible dans chaque nouvelle conversation.

Puis-je utiliser Quick Event avec ChatGPT ?

**Oui** — via un GPT personnalisé avec une Action basée sur notre spécification OpenAPI 3.1 : • **OpenAPI :** https://quick-event.com/.well-known/openapi.yaml Dans le ChatGPT GPT Builder, crée un nouveau GPT et ajoute l'URL OpenAPI sous « Actions ». L'authentification est définie sur « Aucune ». Le GPT personnalisé peut ensuite créer des événements via une invite et distribuer les liens générés aux utilisateurs. Remarque : la plateforme de plugins ChatGPT héritée a été dépréciée par OpenAI en 2024 — seuls les GPT personnalisés / Actions sont pris en charge aujourd'hui.

Les webhooks sont-ils disponibles ?

Les Webhooks sont **en cours de développement.** Les fonctionnalités prévues sont : • Notifications en temps réel pour les inscriptions et les annulations • Charges utiles signées (HMAC-SHA256) pour une vérification sécurisée • Uniquement HTTPS avec logique de réessai (3× délai d'attente exponentiel) • Filtres d'événements configurables par URL de webhook L'intégration des webhooks permettra de connecter Quick Event à n'importe quel système externe — CRM, Slack, tes propres backends. Soumets une demande de fonctionnalité sur la page de la feuille de route pour être informé de sa sortie.

Ai-je besoin d'une clé API ou d'une authentification ?

Non. L'API publique ne requiert aucune authentification. N'importe qui peut créer un événement via une requête POST. La seule limite est le nombre d'événements : un maximum de 5 événements de démonstration par adresse IP et par période de 24 heures. Les événements créés expirent au bout de 30 jours, sauf s'ils sont rendus permanents via la création d'un compte gratuit. Toutes les connexions se font via HTTPS avec TLS 1.3.

Quels services tiers Quick Event utilise-t-il ?

Quick Event utilise les services suivants en arrière-plan : • SendGrid : Livraison d’emails avec prise en charge des domaines personnalisés (DKIM, SPF) • Stripe : Traitement des paiements pour les billets payants et les abonnements • Pexels : Photos libres de droits disponibles directement dans l’éditeur de pages • Cloudflare : Hébergement (Workers), stockage de fichiers (R2), certificats SSL, domaines personnalisés et CDN Ces services sont entièrement intégrés ; vous n’avez pas besoin de créer vos propres comptes pour utiliser Quick Event.

Intégrations et API

Quick Event peut être intégré à des flux de travail externes de plusieurs manières — un point d'accès public de création d'événements, un serveur MCP pour les assistants IA comme Claude Desktop, un manifeste OpenAPI pour les GPT personnalisés de ChatGPT, et une API REST complète prévue pour la lecture des données d'événements, de participants et de réservations. Cet article décrit les interfaces disponibles et les services tiers qui fonctionnent en arrière-plan.

Aperçu

Actuellement, deux couches d'intégration sont disponibles : le serveur MCP , qui fournit Quick Event comme outil du protocole MCP pour les assistants IA tels que Claude Desktop, et une spécification OpenAPI pour l'intégration avec ChatGPT et d'autres plateformes compatibles OpenAPI. Ces deux interfaces permettent aux utilisateurs de créer un événement complet avec une page d'accueil , un formulaire d'inscription , des modèles d'e-mails et des catégories de billets à l'aide de descriptions textuelles.

API REST Partiel — API de lecture en cours de développement

Un **point d'accès public de création d'événements** est disponible dès aujourd'hui à l'adresse POST /api/public/create-event : envoie une description en langage naturel (avec date, lieu et langue facultatifs) et Quick Event génère un événement complet — page de destination, formulaire d'inscription, modèles d'e-mail, catégories de billets — en utilisant l'IA. Aucune authentification n'est requise ; la limite de taux est de 5 événements de démonstration par IP toutes les 24 heures, et les événements de démonstration expirent après 30 jours, sauf s'ils sont revendiqués par un compte gratuit. Le même point d'accès prend en charge le serveur MCP et l'intégration ChatGPT.

Une **API de lecture complète** pour l'accès programmatique aux événements, participants et réservations est en cours de développement. Elle te permettra d'intégrer Quick Event avec les systèmes CRM existants, les outils marketing ou les flux de travail internes sans exportations manuelles de données. Des mutations authentifiées (annuler une réservation, rembourser un billet, modifier les données des participants) sont prévues en parallèle. Les détails sur les points d'accès, l'authentification et les formats de données suivront avec la publication.

Serveur MCP

Le serveur MCP (Model Context Protocol) rend Quick Event disponible en tant qu'outil dans les assistants IA tels que Claude Desktop, Cursor, Claude Code et tout autre client compatible MCP.

Le serveur implémente la version 2025-11-25 du protocole MCP via le transport HTTP streamable à l'adresse /api/public/mcp (JSON-RPC 2.0, aucune authentification, CORS activé). Il prend en charge les méthodes initialize, tools/list et tools/call. Le seul outil enregistré est create_event et il accepte les mêmes paramètres que l'API REST.

En pratique : tu décris un événement à ton assistant IA, et il appelle l'outil MCP pour le créer. Les liens générés apparaissent directement dans la conversation.

Configuration dans Claude Desktop

Les clients MCP ne découvrent *pas* automatiquement les serveurs à partir d'une URL — tu ajoutes le point d'accès au fichier de configuration du client. Dans Claude Desktop, modifie claude_desktop_config.json (Paramètres → Développeur → Modifier la configuration) et ajoute un serveur MCP distant pointant vers https://quick-event.com/api/public/mcp. Redémarre Claude Desktop et l'outil create_event devient disponible dans les nouvelles conversations. Cursor, Claude Code et d'autres clients utilisent un modèle de fichier de configuration similaire. Un résumé lisible par machine du serveur (nom, point d'accès, schémas d'outils) est également publié à l'adresse /.well-known/mcp.json pour la documentation et les outils qui souhaitent le lire.

Intégration ChatGPT

Quick Event publie une **spécification OpenAPI 3.1** à l'adresse /.well-known/openapi.yaml pour être utilisée comme Action de GPT personnalisé ChatGPT.

Dans le ChatGPT GPT Builder, crée un nouveau GPT, ouvre **Configurer → Actions**, et importe l'URL OpenAPI. Le champ d'authentification reste sur « Aucune ». Le GPT personnalisé peut alors créer des événements à partir d'une invite et afficher les liens renvoyés à l'utilisateur. La spécification OpenAPI documente le point d'accès en détail — schéma de requête, exemples de réponse et codes d'erreur.

La plateforme de plugins ChatGPT héritée (avec son manifeste ai-plugin.json) a été dépréciée par OpenAI en 2024 et n'est plus prise en charge — les GPT personnalisés avec des Actions OpenAPI sont la voie actuelle.

Webhooks Prévu

Les Webhooks sont **en cours de développement.** Ils permettront d'envoyer automatiquement des requêtes HTTP à une URL configurable en réponse à certains événements — tels qu'une nouvelle inscription, une annulation ou un changement de statut.

L'architecture prévue comprend des charges utiles signées (HMAC-SHA256), une livraison uniquement via HTTPS, et une logique de réessai avec trois tentatives et un délai d'attente exponentiel. Les filtres d'événements permettront de s'abonner uniquement à des types d'événements spécifiques par URL de webhook.

Une fois les webhooks disponibles, ils permettront des flux de travail tels que les notifications Slack pour les nouvelles inscriptions, la synchronisation CRM ou les e-mails de suivi automatiques via des systèmes externes. Tu veux être informé de sa sortie ? Soumets une demande sur la page de la feuille de route.

Services tiers

Quick Event utilise plusieurs services spécialisés en arrière-plan. En tant qu'utilisateur, tu n'as pas besoin de créer un compte séparé chez aucun de ces fournisseurs — l'intégration est entièrement intégrée à la plateforme.

SendGrid (E-mail)

Tous les e-mails transactionnels — confirmations d'inscription, rappels, e-mails de campagne — sont livrés via SendGrid. Quick Event configure automatiquement les enregistrements DKIM et SPF pour les domaines personnalisés, garantissant que les e-mails sont envoyés depuis ta propre adresse d'expéditeur et atteignent un taux de délivrabilité élevé.

Stripe (Paiements)

Les billets payants sont traités via Stripe Connect — les fonds sont directement acheminés vers le compte bancaire de l'organisateur, jamais détenus par Quick Event. Le Studio t'intègre à Stripe Connect lors de ton premier événement payant, affiche le statut chargesEnabled et payoutsEnabled, et gère automatiquement les remboursements et les factures conformes à la TVA. Les paiements par carte, Apple Pay, Google Pay, SEPA et d'autres méthodes de paiement locales sont pris en charge nativement. Les frais par billet de Quick Event (0,99 € + 2,75 %) sont déduits de chaque versement Stripe — consulte Billets payants pour le processus complet.

Pexels (photos de stock)

Le constructeur de pages inclut une recherche d'images intégrée via l'API Pexels. Tu peux choisir parmi des millions de photos gratuites et libres de droits directement lors de la création d'une page d'événement et les intégrer à ta page — sans aucun téléchargement ou téléversement séparé.

Cloudflare (Infrastructure)

L'ensemble de la plateforme fonctionne sur Cloudflare Workers. Les fichiers (logos, PDF, images) sont stockés dans Cloudflare R2. Les domaines personnalisés reçoivent automatiquement des certificats SSL via Cloudflare for SaaS. Le CDN mondial garantit des temps de chargement rapides, quelle que soit la localisation des participants.