Webhookid

Webhookid saadavad sinu hallatavale URL-ile väikese sõnumi iga kord, kui midagi juhtub PeekHire’is — nii saad API pideva pärimise asemel reaalajas reageerida.

Kuidas webhookid töötavad

1. Lood lõpp-punkti (URL sinu serveris või automatiseerimistööriistas) jaotises Arendaja tööriistad → Webhookid.
2. Valid, milliseid sündmusi see peaks vastu võtma.
3. Kui sündmus toimub, saadab PeekHire sinu lõpp-punkti HTTP POST päringu koos JSON-payload’iga.

Payload’id on meelega väikesed — need tuvastavad, mis juhtus ja millist objekti see puudutab, et saaksid vajaduse korral täielikud üksikasjad hankida REST API kaudu.

Saadaolevad sündmused

Sündmused katavad värbamise elutsükli, sealhulgas:

• Kandideerimised — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Kandideerimise kommentaarid — application.comment.created, application.comment.updated, application.comment.deleted.
• Kampaaniad — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Edastuste kontrollimine

Iga edastus on allkirjastatud, et saaksid kinnitada, et see tuli tõesti PeekHire’ist. Kontrolli oma lõpp-punktis allkirja enne payload’i usaldamist ja vasta kättesaamise kinnitamiseks 2xx staatusega.

Edastuste uurimine

Vaade Edastused näitab hiljutisi webhooki katseid ja nende tulemusi, et saaksid kinnitada, et sündmused jõuavad kohale, ning siluda lõpp-punkti, mis ei vasta.

Nõuanded

• Vasta kiiresti 2xx staatusega ja tee raskem töö asünkroonselt.
• Tee oma käsitleja idempotentseks — sama sündmus võidakse vahel edastada rohkem kui üks kord.
• Kui sa ei soovi serverit hallata, alusta tööriistaga nagu Make, Zapier või n8n.