Poradnik · 7 min czytania
Poradnik API i automatyzacji kreatora formularzy
Zaktualizowano 2026-09-17
W skrócie
API kreatora formularzy zwykle pozwala tworzyć i zarządzać formularzami za pomocą klucza API przez REST, otrzymywać powiadomienia o nowych odpowiedziach przez podpisane webhooki zamiast odpytywania, i coraz częściej udostępnia serwer MCP, żeby agenci AI piszący kod mogli bezpośrednio tworzyć i czytać formularze.
Gdy formularz przestaje być jednorazowy, zwykle chcesz podłączyć go do czegoś innego: skryptu, który programowo tworzy formularze, systemu, który reaguje w chwili nadejścia odpowiedzi, albo agenta AI, który buduje i edytuje formularze jako część większego przepływu pracy. Ten poradnik omawia trzy elementy, które to umożliwiają: samo API, webhooki do powiadomień w czasie rzeczywistym oraz MCP dla dostępu agentów AI.
Uwierzytelnianie kluczem API
REST API zabezpieczone kluczami API to standardowy sposób skryptowego tworzenia formularzy, wylistowywania odpowiedzi albo pobierania danych do innego systemu, bez sesji przeglądarki. Trzymaj klucz po stronie serwera; wszystko wysłane do przeglądarki jest w praktyce publiczne.
Specyfikacja OpenAPI (opis każdego endpointu w formacie czytelnym maszynowo) pozwala wygenerować bibliotekę kliencką w wybranym języku zamiast ręcznego pisania wywołań HTTP, i to właśnie jej używa większość narzędzi do testowania API do autouzupełniania żądań.
Co zwykle obejmuje REST API w wersji v1
Spodziewaj się endpointów do tworzenia i aktualizowania formularzy, listowania i pobierania pojedynczych odpowiedzi oraz zarządzania podstawami konfiguracji formularza. Wersjonuj API od pierwszego dnia (v1, v2), żeby przyszłe zmiany łamiące kompatybilność po cichu nie zepsuły skryptów zbudowanych na obecnej wersji.
Webhooki do aktualizacji w czasie rzeczywistym
Odpytywanie API na czasomierzu, by sprawdzić nowe odpowiedzi, marnuje żądania i dodaje opóźnienie. Webhook wysyła zamiast tego ładunek do twojego endpointu w chwili nadejścia odpowiedzi, co jest zarówno szybsze, jak i tańsze niż odpytywanie.
Podpisane webhooki (HMAC-SHA256 to popularny standard) pozwalają twojemu endpointowi zweryfikować, że ładunek faktycznie pochodzi z platformy formularzy i nie został sfałszowany, a automatyczne ponowienia przy niepowodzeniu dostarczenia oznaczają, że krótka awaria po twojej stronie po cichu nie zgubi zgłoszenia.
Eksport CSV i powiadomienia Slack
Nie każda integracja wymaga niestandardowego kodu. Eksport CSV pokrywa doraźną analizę w arkuszu kalkulacyjnym, a powiadomienie Slack o nowych odpowiedziach pokrywa typowy przypadek, gdy po prostu chcesz, żeby kanał zespołowy widział napływające zgłoszenia, bez budowania czegokolwiek.
MCP: pozwól agentom AI pracować z formularzami bezpośrednio
MCP (Model Context Protocol) to sposób, dzięki któremu agenci AI piszący kod, jak Claude Code, Cursor czy ChatGPT, mogą wywoływać narzędzia bezpośrednio, zamiast człowieka kopiującego odpowiedzi API tam i z powrotem. Platforma formularzy udostępniająca serwer MCP pozwala agentowi utworzyć formularz, przeczytać odpowiedzi albo dostosować ustawienia jako część większego zadania, korzystając z tego samego bazowego API, ale przez znormalizowany interfejs, który agent już wie, jak wywoływać.
Ma to coraz większe znaczenie dla zespołów budujących wewnętrzne narzędzia z agentami AI: zamiast pisać niestandardowy kod integracji API do jednorazowego zadania z formularzem, kierujesz agenta na serwer MCP i opisujesz, czego chcesz.
REST API v1 YeetForm (dokumentacja na yeetform.io/developers) jest uwierzytelniane kluczami API, dostarcza specyfikację OpenAPI, wysyła podpisane webhooki HMAC-SHA256 z automatycznymi ponowieniami przy nowych odpowiedziach i udostępnia serwer MCP, żeby agenci jak Claude Code, Cursor czy ChatGPT mogli bezpośrednio tworzyć formularze i czytać odpowiedzi.