Webhookok
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 webhookok a Rendszerbeállítások menü Webhookok fülén konfigurálhatók. A fül a rendszergazdák számára érhető el (lásd: Felhasználók és jogosultságok). Az adatok más csatornán való olvasásához 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.

| Esemény | Mikor küldi el a FlexiProject a kérést | Eseményspecifikus adatok |
|---|---|---|
| Projekt létrehozva | Új projekt jött létre, bármilyen módon: nulláról, sablonból, klónozással, MS Project- vagy Excel-fájl importálásával, vagy mesterséges intelligencia segítségével. | ProjectId, ProjectName, CreatedAt |
| Projekt törölve | Egy projektet töröltek. | ProjectId, ProjectName |
| Jóváhagyás elindítva | Egy alaptervmódosítást jóváhagyásra beküldtek, és elindult a jóváhagyási útvonala. | ChangeRequestId, ChangeRequestName, ProjectId, ProjectName, Date |
| Jóváhagyás befejezve | A jóváhagyási útvonal eredménnyel zárult: jóváhagyással, elutasítással, javításra visszaadással vagy visszavonással. Archivált projekt esetén a kérés nem megy ki. | ChangeRequestId, ChangeRequestName, ProjectId, ProjectName, DecisionDate, Status |
A Status mező értéke Approved (jóváhagyás), Rejected (elutasítás), NeedsRevision (javításra visszaadás) vagy Pending (visszavonás).
Minden kérés tartalmazza továbbá:
- az esemény nevét (
Event) - a létrehozásának időpontját (
Timestamp) - 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 A HTTP-kérés formátuma rész írja le. A jóváhagyásokról a Jóváhagyások oldalon olvashat.
Webhook konfigurálása
A webhookok listája
A Webhookok fül a szervezet összes webhookját három oszlopban mutatja: Esemény, Fogadó URL és Leírás. Ha semmi sincs megadva, a rendszer a Nincsenek webhookok üzenetet jeleníti meg.

Webhook hozzáadása
- A főmenüben válassza a Rendszerbeállítások lehetőséget, lépjen a Webhookok fülre, és kattintson a Hozzáadás gombra. Megnyílik a Webhook hozzáadása ablak.
- Válassza ki az Esemény értékét. Alapértelmezés szerint a Projekt létrehozva van beállítva.
- Adja meg a Fogadó URL értékét, vagyis 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. - Ha szeretné, adjon meg Leírást, vagyis a csapatnak szóló megjegyzést, amely csak a beállításokban látható.
- Kattintson a Mentés gombra. A webhook megjelenik a listán, közvetlenül utána pedig megnyílik a Titkos kulcs ablak.
Titkos kulcs
A Titkos kulcs ablak ezt az üzenetet tartalmazza: 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.
Kattintson a Másolás gombra. Az érték a vágólapra kerül (a rendszer ezt az üzenetet jeleníti meg: Vágólapra másolva), onnan 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).
Fontos: Az ablak bezárása után a teljes érték sehol sem érhető el az alkalmazásban.
Egy 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
Webhook módosításához kattintson az esemény nevére a listán. A Webhook szerkesztése ablakban módosíthatja az eseményt, a fogadó címét és a leírást, majd kattintson a Mentés gombra.
A szerkesztés nem változtatja meg a titkos kulcsot, és nem hoz létre újat.
Webhook tesztelése
Webhook ellenőrzéséhez kattintson a Tesztelés gombra a mentett webhook szerkesztőablakában. A beállított címre a kiválasztott esemény formátumában, mintaadatokkal kitöltött kérés megy (például egy Test Project nevű projekttel). A rendszer ezt az üzenettel erősíti meg: A tesztkérés sikeresen elküldve
Fontos: 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
Webhook törléséhez kattintson a Törlés gombra a webhook ablakában, és erősítse meg. Ettől kezdve az esemény többé nem megy ki arra a címre.
Figyelem: A törlés nem vonható vissza. A kézbesítés újraindításához új webhookot kell létrehozni, amelynek új titkos kulcsa van.
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
| Fejléc | Tartalom |
|---|---|
X-FlexiProject-Event |
Az esemény neve: ProjectCreated, ProjectDeleted, AcceptanceStarted vagy AcceptanceCompleted. |
X-FlexiProject-Delivery |
A kézbesítés azonosítója. Ugyanazon esemény minden újrapróbálkozásánál ugyanaz marad, így ebből felismerhetők az ismétlődések. |
X-FlexiProject-Timestamp |
A kérés elküldésének időpontja. |
X-FlexiProject-Signature |
A kérés törzsének aláírása sha256=<value> formában. |
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ó ugyanezt az értéket kiszámítja a kapott törzsből, és összehasonlítja az X-FlexiProject-Signature fejléc sha256= utáni részével. Ha az értékek eltérnek, a kérést el kell utasítani, mert nem a FlexiProject ezen szervezetétől érkezett.
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
A fogadó sikeres állapotkóddal (2xx) válaszol, amint elfogadja a kérést. 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. Az összes próbálkozás nagyjából tizenhét órát vesz igénybe, így az a fogadó, amely egy ideig nem érhető el, nem veszíti el az eseményt.
Fontos: Minden próbálkozás ugyanazt az X-FlexiProject-Delivery értéket ismétli, ezért a fogadónak kezelnie kell, hogy ugyanazt az eseményt többször is megkaphatja.