Webhooky pre vlastný systém

• document.issued, doklad vystavený
• document.sent, doklad odoslaný klientovi
• document.paid, doklad uhradený
• document.received, prišiel prijatý doklad
• package.ready, mesačný balík je hotový

Iné udalosti zatiaľ neposielame. Endpoint založený v appke počúva všetkých päť.

Pošleme POST s telom v JSON tvare {"event": "document.paid", "sentAt": "2026-03-01T08:15:00.000Z", "data": { ... }}. V data je doklad alebo balík, ktorého sa udalosť týka, sentAt je čas odoslania.

Pri založení endpointu ti appka raz ukáže tajomstvo (whsec_...), ulož si ho, druhýkrát sa nezobrazí; v zozname potom vidíš už len jeho začiatok. Každá správa nesie hlavičky x-simfa-event, x-simfa-timestamp (čas v sekundách) a x-simfa-signature.

1. 1Vezmi telo správy presne tak, ako prišlo, bez preformátovania.
2. 2Zlož reťazec timestamp.telo: hodnota hlavičky x-simfa-timestamp, bodka, telo.
3. 3Spočítaj z neho HMAC-SHA256 svojím tajomstvom a šestnástkový výsledok porovnaj s hlavičkou x-simfa-signature.
4. 4Porovnávaj funkciou odolnou voči meraniu času a odmietni správu so starým časom.

Tlačidlo Test pri endpointe pošle skutočnú správu s udalosťou document.issued, v tele má test: true a žiadny doklad za ňou nie je. Odpoveď tvojho systému uvidíš hneď na obrazovke a posledné pokusy sa vypisujú pri endpointe aj s dôvodom neúspechu.

• Odpoveď so stavovým kódom 2xx. Čokoľvek iné je pre nás neúspech.
• Odpoveď do 10 sekúnd, potom spojenie zavrieme. Prácu si odlož a sprav ju až po odpovedi.
• Konečnú adresu. Presmerovanie nenasledujeme.
• Verejnú adresu. Na localhost a adresy vnútornej siete neposielame nič.

• Pozastavený endpoint nedostáva nič, pozri, či je spustený.
• Doručujeme len v Premium. Po prechode na Free endpointy ostanú, správy prestanú chodiť.
• Po Rotovať platí nové tajomstvo okamžite; staré podpisy už nesedia.