Webhook požadavky

Když dojde k události, Emailit odešle HTTP POST požadavek na vámi nakonfigurovanou webhook URL. Tato stránka popisuje formát požadavku, hlavičky a způsob doručování.

Formát požadavku

Všechny webhook požadavky jsou odesílány jako POST požadavky s JSON tělem:

Metoda: POST
Content-Type: application/json
Timeout: 30 sekund

Hlavičky

Každý webhook požadavek obsahuje následující hlavičky:

Hlavička	Popis
`Content-Type`	`application/json`
`User-Agent`	`Emailit-Webhooks/2.0`
`X-Emailit-Signature`	HMAC-SHA256 podpis pro ověření pravosti
`X-Emailit-Timestamp`	Unix timestamp okamžiku podepsání požadavku

Tělo požadavku

Tělo požadavku obsahuje data události ve formátu JSON:

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.delivered",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      ...
    }
  }
}

Očekávaná odpověď

Váš endpoint by měl vrátit stavový kód 2xx (např. 200, 201, 204) pro potvrzení přijetí. Jakýkoliv jiný stavový kód je považován za chybu.

Strategie opakování

Pokud váš endpoint neodpoví stavovým kódem 2xx do 30 sekund, Emailit bude opakovat doručení podle následujícího plánu:

Pokus	Zpoždění
0	5 sekund
1	5 minut
2	30 minut
3	2 hodiny
4	5 hodin
5	10 hodin
6	24 hodin

Po pokusu 6 (celkem 7 pokusů) je webhook automaticky deaktivován. Můžete jej znovu aktivovat z Emailit dashboardu.

Pořadí

Webhook události jsou doručovány téměř v reálném čase, ale není zaručeno, že dorazí ve správném pořadí. Pro správné řazení ve vaší aplikaci použijte event_id a časové značky v datech události.

IP adresy

Webhook požadavky jsou odesílány z infrastruktury Emailit. Pokud potřebujete povolit konkrétní IP adresy, kontaktujte podporu pro aktuální seznam odchozích IP adres.

Doporučené postupy

Odpovídejte rychle — Zpracujte webhook asynchronně a okamžitě vraťte 2xx. Náročné zpracování proveďte na pozadí.
Ošetřete duplikáty — Použijte event_id pro odstranění duplicitních událostí. Stejná událost může být během opakování doručena vícekrát.
Ověřujte podpisy — Vždy validujte hlavičku X-Emailit-Signature, abyste se ujistili, že požadavek pochází od Emailit. Viz Podpis požadavku.