# HTTP-API: andere Plattformen

> Ereignisse von jeder Plattform an DataFirefly Server-Side senden: Endpoint /v1/events, X-Dfss-Header, HMAC-SHA256-Signatur, Browser-Kanal /v1/collect.

- Originalseite: https://server-side.datafirefly.com/de/docs/http-api.html
- Sprache: de
- Aktualisiert am: 2026-09-01
- Herausgeber: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/de/

---

Ihre Plattform hat kein eigenes Modul? Die API akzeptiert signierte Ereignisse von jedem Backend.

## Der Endpoint

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

Drei Pflicht-Header:

| Header | Inhalt |
| --- | --- |
| `X-Dfss-Tenant` | Ihre Site ID |
| `X-Dfss-Timestamp` | Unix-Timestamp in **Sekunden**, Toleranz 300 Sekunden. NTP-synchronisierte Uhr empfohlen. |
| `X-Dfss-Signature` | HMAC-SHA256 des **exakt gesendeten Roh-Bodys**, hexadezimal in Kleinbuchstaben, berechnet mit Ihrem HMAC-Secret |

## Die goldene Regel der Signatur

Serialisieren Sie das JSON **ein einziges Mal**, signieren Sie diese Zeichenkette, senden Sie genau diese Zeichenkette. Fast alle `invalid_signature`-Fehler entstehen durch ein erneutes Encoding des Bodys zwischen Signatur und Versand.

Vollständige Beispiele in PHP und Node finden Sie im Leitfaden **Custom platform** Ihres Kundenbereichs, auf der Seite Modules.

## Der Browser-Kanal

```
POST https://serverside.datafirefly.com/v1/collect/IHR-PUBLIC-TOKEN
Content-Type: text/plain
```

Dieser leichtgewichtige Kanal verwendet das **Public pixel token** von der Seite Ihrer Website. Er ist dafür gemacht, aus den Seiten heraus aufgerufen zu werden: Er akzeptiert nur Navigationsereignisse und lehnt Käufe und Erstattungen bewusst ab, die über den signierten Server-Kanal laufen müssen.

## Wenn etwas nicht funktioniert

- `401 unknown_tenant`: Website noch nicht aktiviert, oder falsche Site ID.
- `401 invalid_signature`: Der Body wurde zwischen Signatur und Versand erneut encodiert.
- `401 timestamp_out_of_window`: Timestamp in Millisekunden statt Sekunden, oder nicht synchronisierte Uhr.
- Alle Details finden Sie im [Leitfaden zur Fehlerbehebung](https://server-side.datafirefly.com/de/docs/troubleshooting.html).

Aktualisiert: 1. September 2026
