A webhook lehetővé teszi, hogy a FlexiProject abban a pillanatban értesítsen egy külső rendszert, amikor a szervezetben történik valami. Ahelyett, hogy az API-t újra és újra lekérdezné, hogy változott-e valami, a rendszere HTTP-kérést kap az esemény adataival közvetlenül az esemény bekövetkezte után.

Egy webhook egy esemény és egy fogadó cím összekapcsolására szolgál. Ha két különböző eseményt ugyanarra a címre, vagy ugyanazt az eseményt két rendszernek szeretne elküldeni, hozzon létre két webhookot.

A webhookokat a Rendszerbeállítások > Webhookok menüpontban konfigurálhatja. A szakasz a rendszeradminisztrátorok számára érhető el (lásd: Felhasználók és jogosultságok). Ha az adatokat más csatornán szeretné olvasni, használja az API-t.

Események

A FlexiProject négy eseményt jelez. Minden webhook pontosan egyet figyel közülük, amelyet az Esemény listából választ ki.

Minden kérés tartalmazza továbbá az esemény nevét (event), a létrehozásának időpontját (timestamp), valamint annak a felhasználónak az azonosítóját (userId) és e-mail-címét (userEmail), akinek a művelete kiváltotta. A teljes kérés formátumát a következő szakasz írja le: A HTTP-kérés formátuma. A jóváhagyásokról a Jóváhagyások oldalon olvashat.

Webhook konfigurálása

A webhookok listája

A Webhookok oldal a szervezet összes webhookját három oszlopban mutatja: Esemény, Fogadó URL és Leírás. Ha semmi sincs megadva, a Nincsenek webhookok üzenet jelenik meg.

Webhook hozzáadása

1. Kattintson a lista feletti hozzáadás gombra. Megnyílik a Webhook hozzáadása ablak.
2. Válassza ki az Esemény mező értékét. Alapértelmezés szerint a Projekt létrehozva van beállítva.
3. Adja meg a Fogadó URL mező értékét — azt a címet, amelyre a FlexiProject a kérést küldi. A mező kötelező, és a teljes címet kéri a protokollal együtt, például https://example.com/hooks/flexiproject. A hiányos címet az adatfeldolgozási hibát jelző üzenettel elutasítja.
4. Szükség esetén töltse ki a Leírás mezőt — ez a csapatnak szóló megjegyzés, amely csak a listán látható.
5. Kattintson a Mentés gombra.

Titkos kulcs

Közvetlenül a mentés után megjelenik a Titkos kulcs ablak ezzel az üzenettel: A webhook létrejött. Alább található a titkos kulcs, amely csak egyszer jelenik meg. Másolja ki és őrizze biztonságos helyen. A Másolás gomb a vágólapra teszi az értéket (üzenet: Vágólapra másolva), Ön pedig elmenti a fogadó rendszerben. A titkos kulcs minden kérést aláír, így a fogadó megerősítheti, hogy a kérés a FlexiProject rendszertől érkezik (lásd: A HTTP-kérés formátuma).

Az ablak bezárása után a teljes érték sehol sem érhető el az alkalmazásban. Később megnyitott webhookban a Titkos kulcs mező csak az első és az utolsó négy karaktert mutatja, közöttük csillagokkal; a mező nem szerkeszthető.

Webhook szerkesztése

Kattintson a listán egy esemény nevére, hogy megnyíljon a Webhook szerkesztése ablak. Itt módosíthatja az eseményt, a fogadó címét és a leírást, majd kattintson a Mentés gombra. A titkos kulcs változatlan marad — a szerkesztés soha nem állít ki újat. Ha az ablakot mentetlen módosításokkal zárja be, megjelenik a kérdés: Tovább akarsz lépni és lemondani a változásról?

Webhook tesztelése

A Tesztelés gomb a mentett webhook szerkesztőablakában található. A kiválasztott esemény formátumában, mintaadatokkal kitöltött kérést küld a beállított címre (például egy Test Project nevű projekttel), és megerősíti: A tesztkérés sikeresen elküldve. Az üzenet azt erősíti meg, hogy a kérést elküldték, nem azt, hogy a fogadó elfogadta — az eredményt a fogadó oldalon ellenőrizze.

Webhook törlése

A webhook ablakában lévő Törlés gombhoz megerősítés kell a következő kérdésre: Biztosan törli a webhookot? Ettől kezdve az esemény többé nem megy ki arra a címre. A törlés nem vonható vissza; a kézbesítés újraindítása új webhookot, tehát új titkos kulcsot jelent.

A HTTP-kérés formátuma

A FlexiProject JSON törzsű POST kérést küld a beállított címre.

Fejlécek

Az aláírás ellenőrzése

Az aláírás a kérés nyers törzsének HMAC-SHA256 értéke, amelyet a webhook titkos kulcsával mint kulccsal számítanak ki, és kisbetűs hexadecimális formában írnak le. A fogadó oldalon számítsa ki ugyanezt az értéket a kapott törzsből, és hasonlítsa össze az X-FlexiProject-Signature fejléc sha256= utáni részével. Ha az értékek eltérnek, utasítsa el a kérést — nem az Ön szervezetéből indult a FlexiProject rendszerben.

Minta törzs

{
  "projectId": "6712f0a1c3d4e5f601234567",
  "projectName": "Warehouse modernization",
  "createdAt": "2026-09-21T08:14:02Z",
  "userId": "a3f1c7de-1b20-4f9e-9a55-0c2d8e7b41aa",
  "userEmail": "anna.kowalska@example.com",
  "event": "ProjectCreated",
  "timestamp": "2026-09-21T08:14:02Z"
}

Válasz és újrapróbálkozások

Amint elfogadja a kérést, válaszoljon sikeres állapotkóddal (2xx). Minden más válasz, vagy a válasz hiánya sikertelen kézbesítésnek számít.

A sikertelen kézbesítést a rendszer növekvő időközökkel automatikusan megismétli: 1, 2, 4, 8, 16, 32, 64, 128, 256 és 512 perc után. A próbálkozások nagyjából tizenhét órára oszlanak el, így az a fogadó, amely egy ideig nem érhető el, nem veszíti el az eseményt. Minden próbálkozás ugyanazt az X-FlexiProject-Delivery értéket ismétli, ezért készüljön fel arra, hogy ugyanazt az eseményt többször is megkaphatja.