Aller au contenu

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.

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