Jak działa REST API Quick Event?

Publiczne API REST Quick Event umożliwia tworzenie wydarzeń za pomocą żądania HTTP: Punkt końcowy: POST /api/public/create-event Uwierzytelnianie: Nie wymagane — API jest otwarcie dostępne. Limit żądań: 5 wydarzeń demonstracyjnych na adres IP na 24 godziny. Wysyłają Państwo opis (prompt), opcjonalnie zawierający datę, lokalizację i język. Quick Event wykorzystuje AI do wygenerowania kompletnej strony wydarzenia ze stroną docelową, formularzem rejestracyjnym, szablonami e-maili i kategoriami biletów. Odpowiedź zawiera bezpośrednie linki do strony wydarzenia i formularza rejestracyjnego. Wydarzenia demonstracyjne wygasają po 30 dniach. Z darmowym kontem mogą Państwo na stałe przejąć wydarzenie.

Czym jest serwer MCP i jak z niego korzystać?

Serwer MCP (Model Context Protocol) 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 Uwierzytelnianie: brak Narzędzie `create_event` akceptuje te same parametry co API REST. Klienci MCP nie są automatycznie wykrywani z adresu URL — dodają Państwo 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ą wspieraną przez naszą specyfikację OpenAPI 3.1: • OpenAPI: https://quick-event.com/.well-known/openapi.yaml W Kreatorze GPT ChatGPT, prosimy o utworzenie nowego GPT i dodanie adresu 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: platforma starszych 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ą ponawiania (3× wykładnicze wycofywanie) • Konfigurowalne filtry wydarzeń dla każdego adresu URL webhooka Integracja webhooków umożliwi połączenie Quick Event z dowolnym systemem zewnętrznym — CRM, Slack, Państwa własnymi backendami. Prosimy o zgłoszenie prośby o funkcję na stronie planu rozwoju , aby otrzymać powiadomienie, gdy zostanie ona wdrożona.

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?

Quick Event korzysta z następujących usług w tle: • **SendGrid:** Dostarczanie wiadomości e-mail z obsługą niestandardowych domen (DKIM, SPF) • **Stripe:** Przetwarzanie płatności za płatne bilety i subskrypcje • **Pexels:** Bezpłatne zdjęcia stockowe dostępne bezpośrednio w kreatorze stron • **Hetzner:** Hosting, baza danych i przechowywanie plików w niemieckich centrach danych Usługi te są w pełni zintegrowane — nie muszą Państwo tworzyć własnych kont, aby korzystać z Quick Event.

Czy mogę osadzić formularz tworzenia wydarzenia na mojej własnej stronie internetowej?

Quick Event nie oferuje widżetu ani iframe do osadzania. Najczystszym podejściem jest wywołanie publicznego API REST (POST /api/public/create-event) z Pana/Pani własnego backendu i przekierowanie użytkowników do wygenerowanego URL wydarzenia. Nie jest wymagane uwierzytelnianie, a API zwraca bezpośredni link do strony wydarzenia i formularza rejestracyjnego w ciągu kilku sekund.

Jak mogę zsynchronizować rejestracje Quick Event z moim CRM?

Pełne API do odczytu wydarzeń, uczestników i rezerwacji jest w planach rozwoju Quick Event. Zanim zostanie uruchomione, może Pan/Pani ręcznie eksportować dane uczestników ze Studio. Planowane są również webhooki — które będą przesyłać zdarzenia rejestracji i anulowania na wybrany przez Pana/Panią URL — umożliwiając automatyczną synchronizację CRM bez odpytywania.

Jakie dane udostępni planowane API do odczytu?

Nadchodzące API do odczytu zapewni programowy dostęp do wydarzeń, uczestników i rekordów rezerwacji. Obok niego planowane są uwierzytelnione mutacje, takie jak anulowanie rezerwacji czy edycja danych uczestnika. Dokładna struktura endpointów, metoda uwierzytelniania i formaty danych zostaną opublikowane wraz z wydaniem.

Jak działają wypłaty z biletów — czy Quick Event zatrzymuje moje pieniądze?

Wypłaty trafiają bezpośrednio na Pana/Pani konto bankowe za pośrednictwem Stripe Connect. Quick Event nigdy nie przechowuje środków: Studio przeprowadza Pana/Panią przez proces wdrożenia Stripe Connect, gdy tworzy Pan/Pani swoje pierwsze płatne wydarzenie, a każda płatność jest kierowana bezpośrednio na Pana/Pani konto. Opłata za płatne bilety Quick Event — 3,25% + 0,25 € za rezerwację (plus VAT od opłaty), w tym przetwarzanie kart — jest potrącana z każdej wypłaty, więc nie ma oddzielnej faktury. Same moduły są kupowane raz na wydarzenie i nie mają wpływu na to, ile Pan/Pani sprzeda.

Czy zdjęcia stockowe z Pexels są darmowe do wykorzystania na mojej stronie wydarzenia?

Tak. Kreator stron Quick Event integruje API Pexels, dając Panu/Pani dostęp do milionów zdjęć bez tantiem bezpośrednio w edytorze. Nie potrzebuje Pan/Pani konta Pexels ani oddzielnej licencji — integracja jest w pełni osadzona w platformie.

Jak Quick Event zapewnia, że moje e-maile z potwierdzeniem nie trafią do spamu?

Wszystkie e-maile transakcyjne są wysyłane za pośrednictwem SendGrid. Gdy używa Pan/Pani niestandardowej domeny nadawcy, Quick Event automatycznie konfiguruje rekordy DKIM i SPF dla tej domeny, które są głównymi czynnikami technicznymi decydującymi o dostarczalności. Nie potrzebuje Pan/Pani konta SendGrid — integracja działa w całości w ramach Quick Event.

Integracje i API – Quick Event

Quick Event łączy się z zewnętrznymi narzędziami i przepływami pracy za pośrednictwem kilku interfejsów, dzięki czemu Państwa dane wydarzeń nie pozostają zablokowane w jednym panelu. Publiczny punkt końcowy do tworzenia wydarzeń pozwala programowo uruchamiać wydarzenia. Serwer MCP udostępnia Quick Event asystentom AI, takim jak Claude Desktop, dzięki czemu mogą Państwo tworzyć i zarządzać wydarzeniami konwersacyjnie z własnych narzędzi AI. Manifest OpenAPI pozwala Państwu podłączyć Quick Event do niestandardowych GPT w ChatGPT. Webhooki mogą powiadamiać Państwa systemy, gdy dzieją się kluczowe rzeczy — nowa rejestracja, zakończona płatność, check-in — dzięki czemu mogą Państwo synchronizować dane z CRM, arkuszem kalkulacyjnym lub platformą automatyzacji w czasie rzeczywistym. Pełne REST API do odczytu danych wydarzeń, uczestników i rezerwacji jest planowane w celu uzupełnienia programowego dostępu. Za kulisami Quick Event opiera się również na zaufanych usługach stron trzecich — Stripe do płatności, SendGrid do dostarczania wiadomości e-mail oraz Hetzner do hostingu i przechowywania plików w niemieckich centrach danych — każda wybrana ze względu na niezawodność i zgodność z RODO w zakresie przetwarzania danych.

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.

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

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

Pełne API do odczytu dla programistycznego dostępu do wydarzeń, uczestników i rezerwacji jest w planach. Pozwoli Państwu zintegrować Quick Event z istniejącymi systemami CRM, narzędziami marketingowymi lub wewnętrznymi przepływami pracy bez ręcznego eksportu danych. Zautoryzowane mutacje (anulowanie rezerwacji, 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 (Model Context Protocol) 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 za pośrednictwem transportu 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: opisują Państwo 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 automatycznie wykrywają serwerów z adresu URL — dodają Państwo punkt końcowy do pliku konfiguracyjnego klienta. W Claude Desktop, edytujcie Państwo claude_desktop_config.json (Ustawienia → Deweloper → Edytuj konfigurację) i dodajcie zdalny serwer MCP wskazujący na https://quick-event.com/api/public/mcp. Uruchomcie 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. Podsumowanie serwera w formacie czytelnym maszynowo (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 wykorzystania jako niestandardowa akcja GPT w ChatGPT.

W Kreatorze GPT ChatGPT, prosimy o utworzenie nowego GPT, otwarcie Konfiguruj → Akcje i zaimportowanie adresu 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.

Platforma starszych 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 są obecną ścieżką.

Webhooki

Webhooki są dostępne już dziś jako połączenie CRM. Każda rejestracja, każda późniejsza zmiana i każde skanowanie podczas check-inu jest przesyłane jako podpisany JSON na wybrany przez Pana/Panią adres HTTPS — bezpośrednio do Pana/Pani systemu CRM lub do warstwy automatyzacji, takiej jak n8n, Make czy Zapier.

Ładunki są podpisywane HMAC-SHA256 na podstawie znacznika czasu i treści, dostarczanie odbywa się wyłącznie przez HTTPS i co najmniej raz, a każde miejsce docelowe utrzymuje własny kursor, dzięki czemu uszkodzony punkt końcowy nigdy nie blokuje sprawnego. Dla każdego miejsca docelowego wybiera Pan/Pani, jakie rodzaje rekordów ma otrzymywać: uczestników, rezerwacje, check-iny lub dowolną kombinację.

Połączenie jest jednokierunkowe: dane opuszczają Quick Event, nic nie może być zapisane z zewnątrz. Pełne szczegóły — kształt ładunku, weryfikacja podpisu i gwarancje dostawy — znajdują się na stronie integracji CRM .

Usługi stron trzecich

Quick Event korzysta z kilku wyspecjalizowanych usług w tle. Jako użytkownik, nie muszą Państwo tworzyć oddzielnego 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 Państwa 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 wprowadza Państwa do Stripe Connect przy pierwszym płatnym wydarzeniu, wyświetla statusy 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ą obsługiwane od razu po uruchomieniu. Opłata za płatność Quick Event (3,25% + 0,25 € za rezerwację (plus VAT od opłaty), w tym przetwarzanie kart) jest potrącana z każdej wypłaty Stripe — pełny przebieg znajduje się w sekcji Płatne bilety .

Pexels (zdjęcia stockowe)

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

Hetzner (Infrastruktura)

Platforma działa w niemieckich centrach danych obsługiwanych przez Hetzner Online — aplikacja, baza danych i pamięć obiektowa, która przechowuje Państwa pliki (loga, pliki PDF, obrazy). Kopie zapasowe są przechowywane w drugiej niemieckiej lokalizacji. Niestandardowe domeny automatycznie otrzymują certyfikaty od Let’s Encrypt, gdy tylko zostaną zweryfikowane.

Połącz Quick Event z Pana/Pani narzędziami i przepływami pracy