Webhooki

Webhooki pošljejo kratko sporočilo na URL, ki ga nadzorujete, kadar koli se kaj zgodi v PeekHire — tako se lahko odzovete v realnem času, namesto da bi preverjali API.

Kako delujejo webhooki

1. Ustvarite končno točko (URL na svojem strežniku ali orodje za avtomatizacijo) v Orodja za razvijalce → Webhooki.
2. Izberete, katere dogodke naj prejema.
3. Ko se dogodek zgodi, PeekHire pošlje HTTP POST z vsebino JSON na vašo končno točko.

Vsebine so namenoma majhne — povedo, kaj se je zgodilo in na kateri predmet se nanaša, zato lahko po potrebi pridobite vse podrobnosti prek REST API.

Razpoložljivi dogodki

Dogodki pokrivajo življenjski cikel zaposlovanja, vključno z:

• Prijave — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Komentarji prijav — application.comment.created, application.comment.updated, application.comment.deleted.
• Kampanje — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Preverjanje dostav

Vsaka dostava je podpisana, zato lahko preverite, ali je res prišla iz PeekHire. Preden zaupate vsebini, preverite podpis na svoji končni točki in odgovorite s statusom 2xx, da potrdite prejem.

Pregledovanje dostav

Pogled Dostave prikazuje nedavne poskuse webhookov in njihove rezultate, zato lahko preverite, ali dogodki prihajajo, in odpravite napake na končni točki, ki se ne odziva.

Nasveti

• Hitro odgovorite z 2xx, zahtevnejše delo pa opravite asinhrono.
• Poskrbite, da bo vaš obdelovalnik idempotenten — isti dogodek je lahko občasno dostavljen več kot enkrat.
• Začnite z orodjem, kot je Make, Zapier ali n8n, če raje ne bi upravljali strežnika.