# API HTTP: pozostałe platformy

> Wysyłaj zdarzenia do DataFirefly Server-Side z dowolnej platformy: endpoint /v1/events, nagłówki X-Dfss, podpis HMAC-SHA256, kanał przeglądarkowy /v1/collect.

- Strona oryginalna: https://server-side.datafirefly.com/pl/docs/http-api.html
- Język: pl
- Zaktualizowano: 2026-09-01
- Wydawca: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/pl/

---

Twoja platforma nie ma dedykowanego modułu? API przyjmuje podpisane zdarzenia z dowolnego backendu.

## Endpoint

```
POST https://serverside.datafirefly.com/v1/events
```

Trzy 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/plain
```

Ten 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](https://server-side.datafirefly.com/pl/docs/troubleshooting.html).

Aktualizacja: 1 września 2026
