Documentation Démarrage en 5 minutes
Démarrage en 5 minutes
De la clé à la première offre en ligne, avec curl. Remplacez la clé par la vôtre, le reste se copie tel quel.
Votre clé
Créez-la dans l'espace de votre Grand compte (l'API Emploi vient avec la formule Grands comptes). Elle ne s'affiche qu'une fois : rangez-la dans votre gestionnaire de secrets.
export HEYALINK_CLE="hl_emploi_live_…"
Vérifiez-la
L'appel moi dit à quelle page appartient la clé, ses droits et vos limites.
curl https://heyalink.com/api/emploi/v1/moi \
-H "Authorization: Bearer $HEYALINK_CLE"
{
"entreprise": {
"nom": "Bâtisseurs de Garonne",
"adresse": "https://heyalink.com/…"
},
"cle": {
"nom": "Logiciel de recrutement", "api": "emploi", "debut": "hl_emploi_live_k3",
"droits": ["offres:lecture", "offres:ecriture"], "creee_le": "2026-10-28T10:12:00+01:00"
},
"limites": { "appels_par_minute": 300, "annonces_par_lot": 100 },
"success": true
}
Essayez à blanc
Avec dry_run=1, tout est vérifié et la réponse est celle d'une vraie écriture, avec "simulation": true. Rien n'est publié.
curl -X PUT "https://heyalink.com/api/emploi/v1/offres/CC-2026-014?dry_run=1" \
-H "Authorization: Bearer $HEYALINK_CLE" \
-H "Content-Type: application/json" \
-d @offre.json
Publiez l'offre
Le même appel, sans dry_run. Votre référence est la clé de l'annonce : renvoyer la même référence la modifie. L'en-tête Idempotency-Key protège d'un double envoi pendant 24 heures.
curl -X PUT https://heyalink.com/api/emploi/v1/offres/CC-2026-014 \
-H "Authorization: Bearer $HEYALINK_CLE" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 7f3c2a9e-cc-2026-014" \
-d '{
"titre": "Chef de chantier gros œuvre",
"description": "<p>Vous dirigez deux équipes sur des chantiers de logements collectifs.</p>",
"lieu": "Toulouse (31)",
"code_postal": "31000",
"type_contrat": "CDI",
"lien_candidature": "https://www.exemple.fr/offres/CC-2026-014"
}'
{
"offre": {
"reference": "CC-2026-014",
"etat": "en_ligne",
"code_rome": "F1202",
"adresse": "https://heyalink.com/…"
},
"resultat": "creee",
"avertissements": []
}
Publication arrêtée ? Quand un prélèvement n'est pas passé, ou quand le plafond du mois est atteint, l'offre est enregistrée avec
"etat": "en_attente"et son motif ; elle paraît dès que le paiement passe, ou au plus tard le 1er du mois suivant.
Soyez prévenu
Chaque changement d'une annonce (annonce.publiee, annonce.expiree…) arrive en POST sur votre adresse, signé par l'en-tête Heyalink-Signature: t=…,v1=…. Vérifiez la signature, et refusez au-delà de 5 minutes.
import { createHmac, timingSafeEqual } from 'node:crypto';
export function signatureValide(entete, corpsBrut, secret) {
const { t, v1 } = Object.fromEntries(
entete.split(',').map(p => p.split('='))
);
if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
const attendu = createHmac('sha256', secret)
.update(`${t}.${corpsBrut}`).digest('hex');
return timingSafeEqual(Buffer.from(attendu), Buffer.from(v1));
}
C'est tout. La suite : les offres d'emploi, les formations, les webhooks.