Aller au contenu

Documentation Webhooks

Webhooks

Les webhooks

Plutôt que d'interroger Heyalink, faites-vous prévenir. Sur l'écran API Emploi, ajoutez une adresse https:// de votre site (cinq au plus) et choisissez ses événements. Une adresse de l'API Emploi n'est prévenue que des offres d'emploi : elle n'apprend rien des formations.

Événement Quand
annonce.publiee l'offre est en ligne (créée, revenue d'une archive, ou sortie d'attente)
annonce.en_attente l'offre est enregistrée mais attend hors ligne : plafond de facture atteint ou facture impayée (Grands comptes)
annonce.refusee la modération de Heyalink l'a masquée ou retirée
annonce.expiree sa source (flux, page carrières) la dit échue ; depuis le 07/11/2026, une offre envoyée par l'API n'expire plus
annonce.archivee elle est archivée
annonce.pourvue elle est marquée pourvue
annonce.fermee un gérant l'a fermée (sur Heyalink ou par …/fermer) ; elle se rouvre
annonce.rouverte une annonce fermée est de nouveau en ligne
annonce.supprimee un gérant l'a supprimée sur Heyalink, définitivement
annonce.piece_refusee la modération a refusé une photo ou un PDF de l'annonce ; donnees.piece porte id, type (photo ou document) et nom
ping l'essai envoyé depuis l'écran API Emploi

Une adresse peut être une adresse de test : elle ne reçoit que les événements de vos offres de test (clé hl_emploi_test_), et une vraie adresse que ceux de vos vraies offres, jamais les uns chez les autres. Un événement de test porte "bac_a_sable": true dans son corps signé et l'en-tête Heyalink-Bac-A-Sable: oui. Si l'une de vos adresses accumule trop de livraisons en attente (panne de votre côté), les nouvelles ne sont plus préparées jusqu'à ce qu'elle réponde.

Heyalink envoie un POST en JSON :

{
  "id": "evt_8f3k2m1q9x0a7b6c5d4e",
  "evenement": "annonce.refusee",
  "cree_le": "2026-10-19T14:02:11+02:00",
  "bac_a_sable": false,
  "donnees": {
    "nature": "offre",
    "reference": "CC-2026-014",
    "titre": "Chef de chantier",
    "motif": null,
    "adresse": "https://heyalink.com/emplois/chef-de-chantier-12"
  }
}

Vérifiez la signature avant de croire un appel. L'en-tête Heyalink-Signature: t=<horodatage>,v1=<signature> porte un HMAC-SHA256, calculé avec le secret de l'adresse (affiché une seule fois à sa création) sur <horodatage>.<corps brut>. Refusez un horodatage de plus de cinq minutes : un appel rejoué plus tard sera refusé.

[$t, $v1] = sscanf($_SERVER['HTTP_HEYALINK_SIGNATURE'], 't=%d,v1=%s');
$corps = file_get_contents('php://input');
$attendu = hash_hmac('sha256', $t.'.'.$corps, getenv('HEYALINK_SECRET'));
if (! hash_equals($attendu, (string) $v1) || abs(time() - $t) > 300) {
    http_response_code(400);
    exit;
}
// corpsBrut : le corps reçu, tel quel (avant tout JSON.parse).
const [, t, v1] = req.get('Heyalink-Signature').match(/t=(\d+),v1=([a-f0-9]+)/);
const attendu = crypto.createHmac('sha256', process.env.HEYALINK_SECRET)
  .update(`${t}.${corpsBrut}`)
  .digest('hex');
const valide = attendu.length === v1.length
  && crypto.timingSafeEqual(Buffer.from(attendu), Buffer.from(v1))
  && Math.abs(Date.now() / 1000 - Number(t)) <= 300;
# entete : l'en-tête Heyalink-Signature ; corps_brut : le corps reçu, en octets.
t, v1 = (partie.split('=', 1)[1] for partie in entete.split(','))
attendu = hmac.new(os.environ['HEYALINK_SECRET'].encode(),
                   t.encode() + b'.' + corps_brut, hashlib.sha256).hexdigest()
valide = hmac.compare_digest(attendu, v1) and abs(time.time() - int(t)) <= 300

Répondez par un statut 2xx dans les 10 secondes. Sinon, Heyalink réessaie après 1, 5, 30 minutes, puis 2 h, 6 h et 24 h ; Heyalink-Livraison identifie la livraison, pour ne pas traiter deux fois la même. Une adresse en échec 20 fois de suite est désactivée.

Vos choix sur les cookies

Avec votre accord, Heyalink mesure la fréquentation du site avec Google Analytics, et compte les vues des annonces sponsorisées pour les facturer à leurs annonceurs. Rien n'est déposé avant votre choix, et refuser ne change rien à l'usage du site. Votre choix est gardé six mois ; vous pouvez le changer à tout moment par « Gérer les cookies », en bas de page. En savoir plus

Personnaliser

Rien n'est déposé avant votre choix, et refuser ne change rien à l'usage du site. Votre choix est gardé six mois ; vous pouvez le changer à tout moment par « Gérer les cookies », en bas de page. En savoir plus

Choisissez catégorie par catégorie