API dla programistów — Formuliermet.nl

Pierwsze kroki

Wszystkie zapytania trafiają na adres bazowy i przesyłają Twój klucz jako token Bearer; odpowiedź zawsze ma format application/json. Dla każdego klucza określasz dla każdego zasobu (formularze, zgłoszenia), czy może on odczytywać, czy również zapisywać — uprawnienia zapisu nigdy nie są nadawane automatycznie.

Bazowy URL

https://app.formuliermet.nl/api/v1

Uwierzytelnianie

curl https://app.formuliermet.nl/api/v1/me \
  -H "Authorization: Bearer fmb_je_sleutel_hier"

Utwórz klucz w aplikacji w sekcji Konto → API i integracje. Pełny klucz zobaczysz tylko raz — przechowuj go w bezpiecznym miejscu. Klucz daje dostęp do danych Twojego konta; możesz go odwołać w każdej chwili. Dostęp do API jest częścią większych pakietów (zobacz cennik).

Endpointy

GET

/me

Weryfikuje Twój klucz i zwraca identyfikator Twojego konta — przydatne do testowania integracji.

GET

/forms

Formularze z Twojego konta (id, tytuł, slug, aktywny, liczba zgłoszeń). Stronicowane za pomocą ?page i ?limit.

GET

/forms/{id}

Pojedynczy formularz wraz z definicjami pól (id, typ, etykieta, wymagane).

GET

/forms/{id}/submissions

Zgłoszenia dla formularza, od najnowszych. Stronicuj za pomocą ?page i ?limit (maks. 100); pobieraj tylko nowe za pomocą ?since=<data-ISO> — idealne do integracji typu polling.

GET

/submissions/{id}

Pojedyncze zgłoszenie ze wszystkimi wypełnionymi polami w data.

POST

/forms

Tworzy formularz. zakres forms:write

PATCH

/forms/{id}

Aktualizuje formularz (tytuł, pola, ustawienia). zakres forms:write

POST

/forms/{id}/publish · /duplicate · /open · /close

Publikuje, duplikuje albo otwiera/zamyka formularz. zakres forms:write

POST

/submissions/{id}/approve · /reject · /note · /reminder

Zatwierdza lub odrzuca, dodaje wewnętrzną notatkę albo wysyła przypomnienie o płatności. zakres submissions:write

DELETE

/submissions/{id}

Usuwa zgłoszenie wraz z przesłanymi plikami (rejestrowane zgodnie z RODO). zakres submissions:write

Przykład: pobieranie zgłoszeń

curl "https://app.formuliermet.nl/api/v1/forms/FORM_ID/submissions?limit=2" \
  -H "Authorization: Bearer fmb_je_sleutel_hier"

Odpowiedź

{
  "data": [
    {
      "id": "ckv8s2...",
      "formId": "ckv7a1...",
      "sequenceNumber": 42,
      "status": "paid",
      "amountCents": 2500,
      "email": "deelnemer@example.com",
      "paymentMethod": "ideal",
      "createdAt": "2026-06-01T14:30:00.000Z",
      "updatedAt": null,
      "data": { "naam": "Jan Jansen", "aantal": 2 }
    }
  ],
  "page": 1,
  "limit": 2,
  "total": 42
}

Webhooki & zdarzenia w czasie rzeczywistym

Wolisz, żeby dane same trafiały do Ciebie? Skonfiguruj webhooki dla poszczególnych formularzy: wysyłamy metodą POST wiadomość JSON na Twój adres HTTPS, gdy tylko coś się wydarzy — albo do narzędzia takiego jak Zapier czy Make. Możliwe jest też powiadomienie zespołu — bezpośrednio przez Slack lub Microsoft Teams.

Zdarzenia do nasłuchiwania

EVENT

submission.created · submission.paid

Nowe zgłoszenie odebrane i płatność zakończona.

EVENT

submission.approved

Zgłoszenie zatwierdzone w procesie weryfikacji.

EVENT

ticket.checked_in · waitlist.joined

Bilet zeskanowany przy wejściu albo zapis na listę oczekujących.

EVENT

subscription.started · subscription.cancelled

Płatność cykliczna rozpoczęta lub anulowana.

EVENT

form.published

Opublikowano nową wersję Twojego formularza.

Każda wiadomość jest podpisana za pomocą HMAC-SHA256, w razie niepowodzenia ponawiamy próbę automatycznie (z rosnącym odstępem, aż do kilku godzin), a dla każdego formularza widzisz dziennik dostarczania. Dokładne payloady, wszystkie nagłówki oraz gotowy kod weryfikacyjny (Node.js & Python) znajdziesz w interaktywnej dokumentacji.

→ Interaktywna dokumentacja API · Specyfikacja OpenAPI (JSON)

Błędy & limity

400

Nieprawidłowe żądanie — brakuje pola w treści zapytania albo jest ono nieprawidłowe.

401

Brak klucza, klucz jest nieprawidłowy lub został odwołany.

403

Twój pakiet nie obejmuje dostępu do API (ulepsz pakiet — zobacz cennik), albo Twojemu kluczowi brakuje wymaganego zakresu zapisu dla tej akcji.

404

Nie znaleziono, albo formularz/zgłoszenie nie należy do Twojego konta.

409

Konflikt — na przykład wybrany własny adres URL, który jest już zajęty.

429

Zbyt wiele żądań. Obowiązuje wysoki limit na klucz na godzinę.

Każdy klucz widzi wyłącznie dane własnego konta. Nigdy nie udostępniamy przez API ustawień formularza ani połączeń płatniczych — tylko definicje pól i zgłoszenia.

Proste REST API

Pierwsze kroki

Endpointy

Przykład: pobieranie zgłoszeń

Webhooki & zdarzenia w czasie rzeczywistym

Błędy & limity

Wolisz gotową integrację?