Webhookok

Webhookok egy rövid üzenetet küldenek az általad kezelt URL-re, amikor valami történik a PeekHire-ban — így valós időben reagálhatsz az API folyamatos lekérdezése helyett.

Hogyan működnek a webhookok

1. Létrehozol egy végpontot (egy URL-t a szervereden vagy egy automatizációs eszközben) itt: Fejlesztői eszközök → Webhookok.
2. Kiválasztod, mely eseményeket kapja meg.
3. Amikor egy esemény bekövetkezik, a PeekHire egy HTTP POST kérést küld JSON payload-dal a végpontodra.

A payloadok szándékosan kicsik — azonosítják, mi történt, és melyik objektumot érinti, így szükség esetén a teljes részleteket lekérheted a REST API segítségével.

Elérhető események

Az események lefedik a toborzási életciklust, többek között:

• Jelentkezések — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Jelentkezési megjegyzések — application.comment.created, application.comment.updated, application.comment.deleted.
• Kampányok — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Kézbesítések hitelesítése

Minden kézbesítés alá van írva, így ellenőrizheted, hogy valóban a PeekHire-tól érkezett. Ellenőrizd az aláírást a végpontodon, mielőtt megbíznál a payloadban, és válaszolj 2xx státusszal az átvétel visszaigazolásához.

Kézbesítések vizsgálata

A Kézbesítések nézet megmutatja a legutóbbi webhook-próbálkozásokat és azok eredményeit, így ellenőrizheted, hogy az események megérkeznek-e, és hibakeresést végezhetsz egy nem válaszoló végponton.

Tippek

• Válaszolj gyorsan egy 2xx státusszal, a nehezebb feladatokat pedig végezd aszinkron módon.
• Tedd a kezelődet idempotenssé — ugyanaz az esemény időnként egynél többször is kézbesítésre kerülhet.
• Kezdd egy olyan eszközzel, mint a Make, a Zapier vagy az n8n, ha inkább nem futtatnál saját szervert.