Jak działa REST API Quick Event?

Publiczny interfejs API REST usługi Quick Event umożliwia tworzenie zdarzeń za pomocą żądania HTTP: Punkt końcowy: POST /api/public/create-event Uwierzytelnianie: Nie jest wymagane — interfejs API jest powszechnie dostępny. Limit szybkości: 5 zdarzeń demonstracyjnych na adres IP w ciągu 24 godzin. Wysyłasz opis (monit), opcjonalnie zawierający datę, lokalizację i język. Quick Event wykorzystuje sztuczną inteligencję do generowania kompletnej strony wydarzenia z landing page'em, formularzem rejestracyjnym, szablonami wiadomości e-mail i kategoriami biletów. Odpowiedź zawiera bezpośrednie linki do strony wydarzenia i formularza rejestracyjnego. Wydarzenia demonstracyjne wygasają po 30 dniach. Z darmowym kontem możesz na stałe przejąć kontrolę nad wydarzeniem.

Czym jest serwer MCP i jak z niego korzystać?

Serwer MCP (Protokół Kontekstu Modelu) udostępnia Quick Event jako narzędzie w asystentach AI, takich jak Claude Desktop, Cursor i Claude Code: Punkt końcowy: https://quick-event.com/api/public/mcp Transport: Streamable HTTP (JSON-RPC 2.0 przez POST) Wersja protokołu: 2025-11-25 Autoryzacja: brak Narzędzie `create_event` akceptuje te same parametry co API REST. Klienci MCP nie są automatycznie wykrywani z adresu URL — dodajesz punkt końcowy do konfiguracji MCP klienta (np. claude_desktop_config.json ), a narzędzie staje się dostępne w każdej nowej rozmowie.

Czy mogę używać funkcji Quick Event z ChatGPT?

Tak — za pośrednictwem niestandardowego GPT z Akcją opartą na naszej specyfikacji OpenAPI 3.1: • OpenAPI: https://quick-event.com/.well-known/openapi.yaml W narzędziu ChatGPT GPT Builder utwórz nowego GPT i dodaj adres URL OpenAPI w sekcji „Akcje”. Uwierzytelnianie jest ustawione na „Brak”. Niestandardowy GPT może następnie tworzyć wydarzenia za pomocą promptu i rozpowszechniać wygenerowane linki użytkownikom. Uwaga: starsza platforma wtyczek ChatGPT została wycofana przez OpenAI w 2024 roku — obecnie obsługiwane są tylko niestandardowe GPT / Akcje.

Czy webhooki są dostępne?

Webhooki są w planach. Planowane funkcje to: • Powiadomienia w czasie rzeczywistym o rejestracjach i anulowaniach • Podpisane ładunki (HMAC-SHA256) dla bezpiecznej weryfikacji • Tylko HTTPS z logiką ponownych prób (3× wykładnicze wycofanie) • Konfigurowalne filtry zdarzeń dla każdego URL webhooka Integracja webhooków umożliwi połączenie Quick Event z dowolnym systemem zewnętrznym — CRM, Slack, Twoimi własnymi backendami. Prześlij prośbę o funkcję na stronie z planem rozwoju , aby otrzymać powiadomienie, gdy zostanie uruchomiona.

Czy potrzebuję klucza API lub uwierzytelnienia?

Nie. Publiczne API nie wymaga uwierzytelniania. Każdy może utworzyć zdarzenie za pomocą żądania POST. Jedynym ograniczeniem jest limit częstotliwości: maksymalnie 5 wydarzeń demonstracyjnych na adres IP w ciągu 24 godzin. Utworzone wydarzenia wygasają po 30 dniach, chyba że zostaną ustawione na stałe poprzez rejestrację bezpłatnego konta. Wszystkie połączenia nawiązują za pomocą protokołu HTTPS z protokołem TLS 1.3.

Z jakich usług zewnętrznych korzysta Quick Event?

Szybkie zdarzenie korzysta w tle z następujących usług: • SendGrid: dostarczanie wiadomości e-mail z obsługą niestandardowych domen (DKIM, SPF) • Stripe: przetwarzanie płatności za opłacone bilety i subskrypcje • Pexels: Bezpłatne zdjęcia stockowe dostępne bezpośrednio w kreatorze stron • Cloudflare: Hosting (Workers), przechowywanie plików (R2), certyfikaty SSL, domeny niestandardowe i CDN Usługi te są w pełni zintegrowane — nie musisz tworzyć własnych kont, aby korzystać z Quick Event.

Integracje i API

Quick Event można zintegrować z zewnętrznymi procesami na kilka sposobów — publiczny punkt końcowy do tworzenia wydarzeń, serwer MCP dla asystentów AI, takich jak Claude Desktop, manifest OpenAPI dla niestandardowych GPT ChatGPT oraz planowane pełne API REST do odczytu danych wydarzeń, uczestników i rejestracji. Ten artykuł opisuje dostępne interfejsy i usługi stron trzecich, które działają w tle.

Przegląd

Obecnie dostępne są dwie warstwy integracji: serwer MCP , który udostępnia funkcję Quick Event jako narzędzie w protokole Model Context Protocol dla asystentów AI , takich jak Claude Desktop, oraz specyfikację OpenAPI do integracji z ChatGPT i innymi platformami zgodnymi z OpenAPI. Oba interfejsy umożliwiają użytkownikom tworzenie kompletnych wydarzeń ze stroną docelową , formularzem rejestracyjnym , szablonami wiadomości e-mail i kategoriami biletów za pomocą opisów tekstowych.

REST API Częściowe — API do odczytu w planach

Publiczny punkt końcowy do tworzenia wydarzeń jest już dostępny pod adresem POST /api/public/create-event: wyślij opis w języku naturalnym (z opcjonalną datą, lokalizacją i językiem), a Quick Event wygeneruje pełne wydarzenie — stronę docelową, formularz rejestracyjny, szablony e-maili, kategorie biletów — za pomocą AI. Uwierzytelnianie nie jest wymagane; limit wynosi 5 wydarzeń demonstracyjnych na adres IP na 24 godziny, a wydarzenia demonstracyjne wygasają po 30 dniach, chyba że zostaną przypisane do bezpłatnego konta. Ten sam punkt końcowy obsługuje serwer MCP i integrację z ChatGPT .

Pełne API do odczytu dla programowego dostępu do wydarzeń, uczestników i rejestracji jest w planach. Pozwoli Ci to zintegrować Quick Event z istniejącymi systemami CRM, narzędziami marketingowymi lub wewnętrznymi procesami bez ręcznego eksportu danych. Uwierzytelnione mutacje (anulowanie rejestracji, zwrot biletu, edycja danych uczestnika) są planowane równolegle. Szczegóły dotyczące punktów końcowych, uwierzytelniania i formatów danych zostaną podane wraz z wydaniem.

Serwer MCP

Serwer MCP (Protokół Kontekstu Modelu) udostępnia Quick Event jako narzędzie w asystentach AI, takich jak Claude Desktop, Cursor, Claude Code i każdy inny klient kompatybilny z MCP.

Serwer implementuje protokół MCP w wersji 2025-11-25 poprzez transport Streamable HTTP pod adresem /api/public/mcp (JSON-RPC 2.0, bez uwierzytelniania, z włączonym CORS). Obsługuje metody initialize, tools/list i tools/call. Jedynym zarejestrowanym narzędziem jest create_event i akceptuje ono te same parametry co API REST.

W praktyce: opisujesz wydarzenie swojemu asystentowi AI, a on wywołuje narzędzie MCP, aby je utworzyć. Wygenerowane linki pojawiają się w rozmowie.

Konfiguracja w Claude Desktop

Klienci MCP nie wykrywają serwerów automatycznie z adresu URL — dodajesz punkt końcowy do pliku konfiguracyjnego klienta. W Claude Desktop edytuj claude_desktop_config.json (Ustawienia → Deweloper → Edytuj konfigurację) i dodaj zdalny serwer MCP wskazujący na https://quick-event.com/api/public/mcp. Uruchom ponownie Claude Desktop, a narzędzie create_event stanie się dostępne w nowych rozmowach. Cursor, Claude Code i inni klienci używają podobnego wzorca pliku konfiguracyjnego. Czytelne maszynowo podsumowanie serwera (nazwa, punkt końcowy, schematy narzędzi) jest również publikowane pod adresem /.well-known/mcp.json dla dokumentacji i narzędzi, które chcą je odczytać.

Integracja z ChatGPT

Quick Event publikuje specyfikację OpenAPI 3.1 pod adresem /.well-known/openapi.yaml do użytku jako Akcja niestandardowego GPT w ChatGPT.

W narzędziu ChatGPT GPT Builder utwórz nowego GPT, otwórz Konfiguruj → Akcje i zaimportuj adres URL OpenAPI. Pole uwierzytelniania pozostaje na „Brak”. Niestandardowy GPT może następnie tworzyć wydarzenia na podstawie promptu i wyświetlać zwrócone linki użytkownikowi. Specyfikacja OpenAPI w pełni dokumentuje punkt końcowy — schemat żądania, przykłady odpowiedzi i kody błędów.

Starsza platforma wtyczek ChatGPT (z manifestem ai-plugin.json) została wycofana przez OpenAI w 2024 roku i nie jest już obsługiwana — niestandardowe GPT z Akcjami OpenAPI to obecna ścieżka.

Webhooki Planowane

Webhooki są w planach. Umożliwią one automatyczne wysyłanie żądań HTTP na konfigurowalny URL w odpowiedzi na określone zdarzenia — takie jak nowa rejestracja, anulowanie lub zmiana statusu.

Planowana architektura obejmuje podpisane ładunki (HMAC-SHA256), dostarczanie tylko przez HTTPS oraz logikę ponownych prób z trzema próbami i wykładniczym wycofaniem. Filtry zdarzeń pozwolą na subskrybowanie tylko określonych typów zdarzeń dla każdego URL webhooka.

Gdy webhooki będą dostępne, umożliwią one procesy takie jak powiadomienia Slack o nowych rejestracjach, synchronizacja CRM lub automatyczne e-maile follow-up za pośrednictwem systemów zewnętrznych. Chcesz być powiadomiony, gdy to zostanie uruchomione? Prześlij prośbę na stronie z planem rozwoju .

Usługi stron trzecich

Quick Event korzysta z kilku wyspecjalizowanych usług w tle. Jako użytkownik nie musisz tworzyć osobnego konta u żadnego z tych dostawców — integracja jest w pełni wbudowana w platformę.

SendGrid (E-mail)

Wszystkie e-maile transakcyjne — potwierdzenia rejestracji, przypomnienia, e-maile kampanii — są dostarczane za pośrednictwem SendGrid. Quick Event automatycznie konfiguruje rekordy DKIM i SPF dla niestandardowych domen, zapewniając, że e-maile są wysyłane z Twojego własnego adresu nadawcy i osiągają wysoki wskaźnik dostarczalności.

Stripe (Płatności)

Płatne bilety są przetwarzane za pośrednictwem **Stripe Connect** — środki są przekazywane bezpośrednio na konto bankowe organizatora, nigdy nie są przechowywane przez Quick Event. Studio wdraża Cię do Stripe Connect przy pierwszym płatnym wydarzeniu, pokazuje status chargesEnabled i payoutsEnabled oraz automatycznie obsługuje zwroty i faktury zgodne z VAT. Karty, Apple Pay, Google Pay, SEPA i inne lokalne metody płatności są domyślnie obsługiwane. Opłata Quick Event za bilet (€0.99 + 2.75 %) jest potrącana z każdej wypłaty Stripe — zobacz Płatne bilety, aby zapoznać się z pełnym procesem.

Pexels (zdjęcia stockowe)

Kreator stron zawiera zintegrowaną wyszukiwarkę obrazów za pośrednictwem API Pexels. Możesz wybierać spośród milionów darmowych, bezpłatnych zdjęć bezpośrednio podczas tworzenia strony wydarzenia i integrować je ze swoją stroną — bez osobnego pobierania lub przesyłania.

Cloudflare (Infrastruktura)

Cała platforma działa na Cloudflare Workers. Pliki (loga, PDF-y, obrazy) są przechowywane w Cloudflare R2. Niestandardowe domeny automatycznie otrzymują certyfikaty SSL za pośrednictwem Cloudflare for SaaS. Globalna sieć CDN zapewnia szybkie czasy ładowania niezależnie od lokalizacji uczestników.