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.