Custom webhook

corween posiela udalosti monitorovania na HTTP endpoint, ktorý nastavíte v nastaveniach.

Prehľad

Keď sú notifikácie na odoslanie, corween pošle POST požiadavku na webhook URL uloženú v nastaveniach účtu.

POST Vaša webhook URL

HTTP požiadavka

Požiadavka ide na URL, ktorú ste zadali. Na našej strane nie je pevná cesta — endpoint si volíte vy.

Metóda
POST
Content-Type
application/json

Payload

Telo je JSON objekt s poľom events. Každá položka popisuje jednu udalosť.

Názov Typ Popis
events array Pole udalostí zahrnutých v tejto notifikácii.
events[].subject object Sledovaný subjekt, ku ktorému udalosť patrí.
events[].subject.registrationNumber string Identifikátor firmy (IČO, KRS, …). Pri osobách môže byť prázdne.
events[].subject.birthDate date Dátum narodenia osoby v ISO formáte (YYYY-MM-DD). Pri firmách prázdne.
events[].subject.name string Názov subjektu.
events[].eventText string Ľudsky čitateľný popis udalosti.
events[].eventDate date Dátum udalosti v ISO formáte (YYYY-MM-DD).
events[].eventSeverity string Závažnosť udalosti. Jedna z: INFO, MEDIUM, HIGH.

Príklad

Telo požiadavky
{
  "events": [
    {
      "subject": {
        "registrationNumber": "12345678",
        "birthDate": null,
        "name": "Example s.r.o."
      },
      "eventText": "Company entered insolvency proceedings.",
      "eventDate": "2026-08-20",
      "eventSeverity": "HIGH"
    }
  ]
}