Endpoint
POST https://serverside.datafirefly.com/v1/eventsTrzy wymagane nagłówki:
| Nagłówek | Zawartość |
|---|---|
X-Dfss-Tenant | Twój Site ID |
X-Dfss-Timestamp | Uniksowy timestamp w sekundach, tolerancja 300 sekund. Zalecany zegar synchronizowany przez NTP. |
X-Dfss-Signature | HMAC-SHA256 dokładnie tego surowego body, które wysyłasz, zapisany szesnastkowo małymi literami, obliczony z użyciem Twojego sekretu HMAC |
Złota zasada podpisu
Serializuj JSON tylko raz, podpisz ten łańcuch znaków i wyślij dokładnie ten sam łańcuch. Niemal wszystkie błędy invalid_signature biorą się z ponownego zakodowania body między podpisaniem a wysyłką.
Kompletne przykłady w PHP i Node znajdziesz w przewodniku Custom platform w Twoim panelu klienta, na stronie Modules.
Kanał przeglądarkowy
POST https://serverside.datafirefly.com/v1/collect/TWOJ-PUBLICZNY-TOKEN
Content-Type: text/plainTen lekki kanał używa Public pixel token ze strony Twojej witryny. Jest zaprojektowany do wywoływania z poziomu stron: przyjmuje wyłącznie zdarzenia nawigacyjne, a zakupy i zwroty odrzuca z założenia, bo te muszą przechodzić przez podpisany kanał serwerowy.
Gdy coś nie działa
401 unknown_tenant: witryna jeszcze nieaktywowana albo błędny Site ID.401 invalid_signature: body zostało ponownie zakodowane między podpisaniem a wysyłką.401 timestamp_out_of_window: timestamp w milisekundach zamiast sekund albo niezsynchronizowany zegar.- Pełne szczegóły znajdziesz w przewodniku rozwiązywania problemów.
Aktualizacja: 1 września 2026