API dla Twojego CRM

Połącz swój CRM lub narzędzia raportowe z TixFlow i odczytuj swoje wydarzenia, zamówienia, uczestników i klientów.

Co daje API

REST API tylko do odczytu Twoich własnych danych: wydarzenia, zamówienia (z biletami), uczestnicy (bilety z nazwiskami gości i wejściami) oraz klienci (każdy, kto u Ciebie kupił, jeden wpis na adres e-mail). Pełna dokumentacja jest pod adresem /developers/api.

Tworzenie klucza

Portal → Ustawienia → Integracje → Klucze API → Utwórz klucz.

Nadaj kluczowi nazwę (np. „Synchronizacja HubSpot”) i wybierz, co może odczytywać.
Potwierdź, że Twoja organizacja jest administratorem eksportowanych danych kupujących.
Skopiuj klucz od razu – jest wyświetlany tylko raz. Jeśli go zgubisz, unieważnij go i utwórz nowy.

Klucze może tworzyć i unieważniać tylko właściciel profilu organizatora. Klucz odczytuje wyłącznie dane organizatora, dla którego został utworzony.

Wywoływanie API

Wysyłaj klucz w nagłówku Authorization:

curl https://tixflow.org/api/v1/orders?createdFrom=2026-10-01T00:00:00Z \
  -H "Authorization: Bearer tf_live_…"

Listy zwracają data, nextCursor i hasMore. Dopóki hasMore jest true, wywołuj ponownie z cursor=<nextCursor>.

Bieżąca synchronizacja CRM

Sortuj według updatedAt i zapisz ostatni nextCursor. Następnym razem odeślij go, a otrzymasz tylko zmiany – nowe zamówienia, zwroty, wejścia.

# first run: everything, oldest change first
GET /api/v1/orders?sort=updatedAt
# store nextCursor; next run, only what changed since:
GET /api/v1/orders?sort=updatedAt&cursor=<stored nextCursor>

Ten sam rekord może przyjść dwa razy – aktualizuj według id zamiast dodawać nowy.
Zmiany z ostatnich kilku sekund pojawią się przy kolejnym wywołaniu.
Usunięcia nie są zgłaszane.

Zgoda marketingowa

Przy każdym zakupie online kupujący może zaznaczyć dobrowolne pole, że chce otrzymywać Twoje nowości. API zwraca odpowiedź jako marketingConsent: true, false lub null, jeśli nigdy nie zapytano (sprzedaż na miejscu, starsze zamówienia). API eksportuje wszystkich kupujących niezależnie od odpowiedzi – to Ty jako administrator decydujesz, na co ona pozwala.

Limity