Aller au contenu

Retour à la formule Grands comptes

Grands comptes

Les API Emploi et Formation

Les annonces de toutes vos agences, publiées depuis votre logiciel et tenues à jour toutes seules

Vous ajoutez, modifiez ou retirez une offre ou une formation dans votre logiciel : heyalink fait la même chose sur la page pro de l’agence. Rien n’est saisi deux fois.

Deux façons de publier vos offres et vos formations

Vous choisissez, agence par agence. Vous pouvez aussi combiner les deux sur la même page pro.

À la main

Depuis chaque page pro : « Publier une offre » dans la rubrique Emploi, « Publier une formation » dans la rubrique Formation. Pratique pour quelques annonces.

Avec toutes les formules

Automatiquement, par les API

Votre logiciel de recrutement ou de formation envoie vos annonces à heyalink, chacune sur la page pro de son agence. Ajoutée, modifiée ou retirée chez vous, une annonce l’est aussi sur heyalink.

Les deux API sont comprises dans Grands comptes

Ce que les API changent pour un groupe

Plusieurs agences, plusieurs pages pro, un seul logiciel : chaque annonce va au bon endroit.

  • Une clé par page pro

    Chaque agence a sa page pro et ses clés. Une annonce envoyée avec la clé d’une agence n’apparaît que sur sa page.

  • Tout se met à jour seul

    Une annonce ajoutée, modifiée, pourvue ou retirée dans votre logiciel l’est aussi sur heyalink, pour toutes vos agences à la fois.

  • Un seul écran pour le groupe

    L’onglet API de votre espace montre chaque page pro : ses clés, ses webhooks, sa source, et ce qui reste à faire (un site à prouver, une clé à créer, un webhook en échec).

  • Un budget tenu

    Quand la facture atteint le plafond que vous avez choisi, les nouvelles annonces attendent hors ligne, qu’elles arrivent par les API ou à la main.

Trois façons de brancher vos annonces

  1. Sans développement : une adressePour vos offres : l’adresse de votre page carrières, de votre page Greenhouse, Lever, Recruitee, SmartRecruiters ou Ashby, ou d’un flux XML, RSS ou JSON (500 offres et 5 Mo au plus). Pour vos formations : celle de votre catalogue LHEO ou JSON. heyalink la relit tout seul : toutes les 10 minutes au plus vite, toutes les 6 heures au plus tard.
  2. Votre liste complète en un appelVotre logiciel envoie la liste de toutes vos références : les annonces publiées par l’API qui n’y figurent plus sont archivées. Pour vos formations, il peut aussi envoyer votre catalogue LHEO tel quel, 5 Mo au plus.
  3. L’API, annonce par annonceVotre logiciel envoie chaque offre ou chaque formation en JSON. Un assistant IA peut le faire aussi, par le serveur MCP.

Ce que font les deux API

Chaque annonce porte votre référence, son code chez vous. Envoyer deux fois la même référence met l’annonce à jour : elle n’est jamais publiée en double.

L’API Emploi, pour vos offres

Comprise dans Grands comptes

Ce que vous faitesL’appel
Publier une offre, ou la mettre à jour PUT /offres/{reference}
Relire une offre et son état GET /offres/{reference}
Lister vos offres, page après page GET /offres
Dire qu’une offre est pourvue : elle sort de heyalink POST /offres/{reference}/pourvue
Archiver une offre : elle sort de heyalink et revient si vous la renvoyez POST /offres/{reference}/archivage
Retirer une offre DELETE /offres/{reference}
Envoyer jusqu’à 100 offres et 100 retraits en un seul appel POST /offres/lot
Envoyer la liste complète de vos références : les offres publiées par l’API qui n’y figurent pas sont archivées POST /offres/synchronisation

L’API Formation, pour vos formations

Comprise dans Grands comptes Pro Formation

Ce que vous faitesL’appel
Publier une formation, ou la mettre à jour PUT /formations/{reference}
Relire une formation et son état GET /formations/{reference}
Lister vos formations, page après page GET /formations
Dire qu’une session est complète : la formation sort de heyalink POST /formations/{reference}/pourvue
Archiver une formation : elle sort de heyalink et revient si vous la renvoyez POST /formations/{reference}/archivage
Retirer une formation DELETE /formations/{reference}
Envoyer jusqu’à 100 formations et 100 retraits en un seul appel POST /formations/lot
Envoyer la liste complète de vos références : les formations publiées par l’API qui n’y figurent pas sont archivées POST /formations/synchronisation
Envoyer votre catalogue LHEO tel quel, 5 Mo au plus POST /formations/lheo

Et autour des annonces

Les mêmes outils pour les deux API, sur chaque page pro.

  • Les webhooksheyalink prévient votre logiciel par un appel signé quand une annonce est en ligne, en attente, masquée par la modération, expirée, archivée, pourvue, fermée, rouverte, supprimée ou refusée sur une photo ou un PDF. 5 adresses au plus par page pro et par API.
  • Le journalLes derniers appels et leur résultat, gardés 90 jours. Lisible aussi sur l’écran API de chaque page pro.
  • La clé d’essaiLes mêmes réponses qu’une vraie clé, sans rien publier. Les annonces de test s’effacent au bout de 7 jours.
  • La validation à blancAvec une vraie clé, l’appel est vérifié en entier, mais rien n’est publié.
  • OAuth 2.0Pour les logiciels qui le préfèrent : la clé s’échange contre un jeton de 60 minutes.
  • La preuve de vos sitesVous prouvez que vos sites sont les vôtres, par une balise ou un fichier. Personne ne publie en votre nom, et un lien de candidature ne mène que chez vous.
  • Les développeurs invités5 au plus pour tout le groupe. Ils ouvrent l’écran API de chaque page pro et y gèrent leurs clés et leurs webhooks, sans voir les montants, les factures ni le contenu des pages.
  • Le serveur MCPVos assistants IA listent, publient, archivent et retirent vos offres et vos formations, avec la même clé.
  • La vérification de la cléUn appel dit à quelle page pro la clé appartient et ce qu’elle peut faire. Un autre, public et sans clé, donne l’état de l’API.

Les informations d’une annonce

Trois sont obligatoires, pour une offre comme pour une formation. Les autres rangent mieux vos annonces dans les recherches et les filtres.

Une offre d’emploi

Obligatoires

Intitulé du poste
titre
Texte de l’offre
description
Ville (à défaut, celle de la page pro)
lieu

Le poste

Code postal
code_postal
CDI, CDD, intérim, stage…
type_contrat
Durée du contrat (CDD, intérim)
duree_nombre
En jours, semaines ou mois
duree_unite
Temps plein ou partiel
temps_de_travail
Télétravail : non, partiel ou total
teletravail
Apprentissage ou professionnalisation
alternance
Expérience demandée, en mois
experience_mois
Date de fin de l’offre (ignorée depuis le 07/11/2026)
date_expiration
Lien pour postuler chez vous
lien_candidature

La description en blocs

Bloc « Le poste »
description_poste
Bloc « Les missions »
description_missions
Bloc « Le profil »
description_profil
Bloc « Les avantages »
description_avantages

Le salaire

Salaire, tel que vous l’affichez
salaire
Bas de la fourchette, en brut
salaire_min
Haut de la fourchette
salaire_max
Par heure, jour, semaine, mois ou an
salaire_periode

Le métier et le secteur

Métier, en texte
metier
Code du métier
metier_code
Famille de métiers
famille_code
Code ROME
code_rome
Secteur d’activité
secteur

Une formation

Obligatoires

Intitulé
titre
Présentation
presentation
Lien vers votre fiche ou l’inscription
lien

La session

Organisme
organisme
Présentiel, distanciel ou mixte
mode
Ville
lieu
Code postal
code_postal
Durée en heures
duree_heures
Date de la prochaine session
debut
Prix TTC par stagiaire
prix
pro_formation.api.champs.libelles.photo_url
photo_url
pro_formation.api.champs.libelles.photo_base64
photo_base64

Pour qui

Public visé
pour_qui
Niveau demandé (texte libre)
niveau_d_entree
Niveau demandé (code)
niveau_entree
Prérequis
prerequis
Objectifs
objectifs
Infos pratiques
infos_pratiques

Le métier visé

Métier, en texte
metier
Code du métier
metier_code
Famille de métiers
famille_code
Code ROME
code_rome

Financement et certification

Financements : CPF, OPCO, France Travail, Région, employeur
financements
Diplôme, habilitation ou attestation
type_certification
Code RNCP
code_rncp
Code RS
code_rs
pro_formation.api.champs.libelles.certification
certification
pro_formation.api.champs.libelles.diplome
diplome
pro_formation.api.champs.libelles.niveau_certification
niveau_certification
pro_formation.api.champs.libelles.attestation
attestation
Apprentissage ou professionnalisation
alternance

Quand une information manque, heyalink la déduit si c’est possible (le métier, d’après le code ROME ou l’intitulé, par exemple) et vous l’indique. Elle n’est jamais présentée comme la vôtre.

Le logo de la page pro et l’image d’une annonce s’ajoutent sur heyalink : ils ne passent pas par l’API.

Comment obtenir l’accès

L’API Emploi est réservée à Grands comptes

L’API Formation est comprise dans Grands comptes Pro Formation

  1. Souscrivez à Grands comptes et réunissez vos pages proUne page pro par agence ou par établissement, rattachée à votre espace. L’accès s’ouvre dès que la formule est en cours.
  2. Ouvrez l’onglet API de votre espaceLe titulaire et les administrateurs y voient toutes les pages pro du groupe. « Ouvrir » mène à l’écran API de chacune.
  3. Créez une clé par page pro, ou invitez vos développeursLe titulaire et les administrateurs de la page pro créent ses clés : jusqu’à 10 actives par API, une par logiciel. Vos développeurs, 5 au plus pour le groupe, créent les leurs.
  4. Prouvez vos sites, puis publiezUne balise ou un fichier sur votre site suffit. Ensuite, vos annonces paraissent.

Les plafonds

Appels
300 par minute et par clé, 60 avec une clé d’essai
Clés
10 actives par page pro et par API
Lot
100 annonces et 100 retraits par appel
Webhooks
5 adresses par page pro et par API
Développeurs
5 pour tout le groupe, invitations comprises
Facture
Le plafond mensuel que vous choisissez. Une fois atteint, vos nouvelles annonces attendent hors ligne. Le relever remet en ligne celles qui tiennent sous le nouveau plafond.

Si la formule s’arrête, vos clés ne répondent plus, mais elles ne sont pas supprimées. Tout repart quand la formule reprend.

Pour votre prestataire

Tout ce qu’il faut pour brancher votre logiciel. La documentation se lit sans compte, même avant de souscrire.

Adresse de l’API Emploi
https://heyalink.com/api/emploi/v1
Adresse de l’API Formation
https://heyalink.com/api/formation/v1
Format
JSON en UTF-8 ; LHEO en XML pour un catalogue de formations
Description
OpenAPI 3.1, à importer dans Postman, Insomnia ou un générateur de client
Clé
Dans l’en-tête Authorization, une clé par page pro et par API. Une clé de l’API Emploi ne fait rien sur les formations
Rejouer sans risque
En-tête Idempotency-Key, valable 24 heures
Erreurs
Au format RFC 9457, en français ou en anglais
Remplacer une clé
L’ancienne marche encore 7 jours, ou s’arrête tout de suite en cas de fuite

Vos questions

Faut-il un développeur ?

Pas forcément. Si votre page carrières, votre logiciel de recrutement ou votre catalogue de formations a déjà une adresse, collez-la sur l’écran API de la page pro. Ajoutez ensuite sur votre site la balise ou le fichier qui prouve qu’il est à vous. Pour l’API, la personne qui gère votre logiciel s’en charge avec la documentation.

Puis-je publier à la main et par les API ?

Oui, sur la même page pro. Une synchronisation ne touche que les annonces arrivées par la même voie : celles saisies à la main restent telles quelles.

Les annonces des API sont-elles facturées ?

Oui, comme les autres : chaque offre et chaque formation en ligne compte au jour près, selon la grille de Grands comptes. Les annonces en attente ne comptent pas.

Puis-je essayer avant de publier ?

Oui. La clé d’essai donne les mêmes réponses qu’une vraie clé et ne publie rien.

Nos développeurs voient-ils nos factures ?

Non. Un développeur invité n’ouvre que les écrans API de vos pages pro : ni montant, ni facture, ni équipe.

Grands comptes

Toutes vos agences branchées sur heyalink

Abonnement : 499 € HT par mois, sans engagement. Puis vos annonces en ligne, au jour près.

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