Aller au contenu

Documentation Journal des changements

Journal des changements

Versions et journal des changements

L'API Emploi est en v1 (https://heyalink.com/api/emploi/v1). Ce contrat est stable : la v1 n'évolue que de façon compatible (un champ ou un appel de plus, jamais un champ retiré ni un sens changé). Une rupture passerait en v2, à une autre adresse, annoncée à l'avance. La description complète, à jour, est la spécification OpenAPI (https://heyalink.com/api/emploi/v1/openapi.json), qui fait foi.

Version Date Changements
1.13.0 08/11/2026 Changement compatible (rien de retiré ni de renommé). Les demandes de sous-traitance de la page : GET et POST /sous-traitance, GET, PATCH et DELETE /sous-traitance/{demande}, POST …/fermer et …/rouvrir, GET …/candidatures (en lecture). Deux droits de plus, sous_traitance:lecture et sous_traitance:ecriture (une clé d'avant ne les a pas : en créer une nouvelle). Cinq webhooks : sous_traitance.publiee, .fermee, .rouverte, .supprimee, .candidature_recue
1.12.0 07/11/2026 Changement compatible (rien de retiré ni de renommé). Photos et PDF de l'annonce : media[] dans la lecture (id, type, nom, url, taille, ordre, statut : verification, publiee ou refusee), POST …/pieces, PUT …/pieces/ordre, DELETE …/pieces/{piece}, et le webhook annonce.piece_refusee. Chaque pièce est lue par la modération avant d'être montrée aux membres. Une annonce importée n'en porte pas
1.11.0 07/11/2026 Changement compatible (rien de retiré ni de renommé). Fermer et rouvrir : POST /offres/{reference}/fermer et …/rouvrir ; l'aperçu tel qu'un membre le voit : GET /offres/{reference}/apercu. Deux états de plus (fermee, retiree) et trois webhooks (annonce.fermee, annonce.rouverte, annonce.supprimee). Une annonce supprimée sur Heyalink par un gérant ne revient jamais : la même référence répond 409 annonce_supprimee ; une annonce fermée renvoyée reste fermée. Les services de la page, bloc par bloc : GET /services, POST /services (un brouillon), GET /services/{id}, PATCH /services/{id}/blocs/{bloc} (seuls les champs du bloc changent ; photos et PDF en multipart), GET /services/{id}/apercu, POST /services/{id}/publication, POST /services/{id}/fermeture, POST /services/{id}/reouverture, DELETE /services/{id}. La lecture suit le droit de lecture de la clé, l'écriture son droit d'écriture. Les trois mêmes webhooks disent aussi le geste de la page sur un service (nature service, référence : l'identifiant du service), et annonce.publiee sa publication
1.10.0 07/11/2026 Plus de date de fin : date_expiration reste accepté mais est ignoré (aucune erreur, aucun effet) et vaut toujours null dans les réponses ; une offre reste en ligne jusqu'à son archivage (DELETE ou statut). Une date reçue avant ne ferme plus l'offre. Le webhook annonce.expiree ne vise plus que les offres reprises d'une source (flux, page carrières) que la source dit échues. Aucun champ retiré ni renommé
1.9.0 07/11/2026 Changement compatible (rien de retiré ni de renommé, aucun sens changé). La fiche de l’offre : quatre champs facultatifs description_poste, description_missions, description_profil, description_avantages (les blocs de la fiche ; description reste exigée) et duree_nombre, duree_unite (la durée du contrat). Le texte salaire reste accepté ; sans salaire_min ni salaire_max, il donne les trois valeurs du salaire seulement quand il suit une forme sûre (« Mensuel de 2100.0 Euros à 2500.0 Euros », « 2 200 à 2 500 € par mois »), sinon il s’affiche tel quel. Mise à jour d’une offre déjà publiée (PUT sur la même référence) : un champ absent ne change plus rien, un champ obligatoire envoyé vide est refusé (422) ; une création exige toujours titre, description et lieu. Une offre publiée par l’API s’affiche dans la fiche exactement comme une offre saisie sur heyalink
1.8.0 06/11/2026 Aucun changement pour l'API Emploi : la version suit celle de l'API Formation (la fiche Formation)
1.7.0 30/10/2026 Documentation seule : elle dit la règle d'accès en vigueur depuis le 25/10/2026 : l'API Emploi est comprise dans la formule Grands comptes ; l'API elle-même ne change pas
1.7.0 29/10/2026 Dans la réponse, secteur_de_recherche : le secteur (un des dix) sous lequel la offre se trouve dans les filtres de recherche de Heyalink, lu depuis la famille ; aucun champ retiré, aucun sens changé
1.6.0 28/10/2026 Données riches, toutes facultatives : metier_code, famille_code, code_rome, experience_mois, temps_de_travail, teletravail, alternance, salaire_min, salaire_max, salaire_periode (listes fermées, 422 hors liste) ; dans la réponse, ces champs plus secteur et champs_deduits ; bloc signalements (champs ignorés, champs recommandés absents, valeurs déduites, incohérences) dans chaque publication et chaque résultat d'un lot ; le temps de travail, l'expérience, le télétravail et le salaire en nombres sont lus aussi dans les pages carrières balisées et les flux ; aucun champ retiré, aucun sens changé
1.5.0 26/10/2026 État en_attente et champ attente (motif plafond ou impaye, date de parution au plus tard) pour les annonces d'un Grand compte retenues par le plafond de facture ou un impayé ; webhook annonce.en_attente ; une annonce en attente se relit par sa référence et figure dans la liste
1.4.0 21/10/2026 Deux API distinctes, l'API Emploi (/api/emploi/v1) et l'API Formation (/api/formation/v1), chacune avec ses clés (hl_emploi_live_, hl_emploi_test_), sa spécification, ses collections, ses webhooks, son journal et ses outils MCP ; une clé de l'autre API reçoit 403 ; cle.api dans GET /moi ; l'ancienne adresse /api/entreprises/v1 et les anciennes clés restent servies jusqu'à leur remplacement
1.3.0 19/10/2026 Domaines prouvés (/domaines) : exigés pour publier pour de bon, et les liens des annonces doivent y mener ; adresses de webhook de test, champ bac_a_sable et en-tête Heyalink-Bac-A-Sable ; la validation à blanc vaut aussi pour le serveur MCP ; remplacement d'urgence d'une clé ; limite d'appels propre aux clés d'essai ; le journal demande un droit de publication ; le secret OAuth ne passe plus dans l'adresse
1.2.0 19/10/2026 Bac à sable complet (annonces de test listables, effacées après 7 jours), validation à blanc (dry_run), violations dans les erreurs, messages en anglais (Accept-Language), route sante, journal de test, données d'exemple, collections Postman et Bruno, « Tester ma source »
1.1.0 19/10/2026 Clés hl_live_ et hl_test_, droits fins, durée de vie, adresses IP, rotation, OAuth 2.0, Idempotency-Key, en-têtes RateLimit, erreurs RFC 9457, curseur, ETag, webhooks signés, OpenAPI 3.1, serveur MCP, preuve de propriété des sources
1.0.0 19/10/2026 Offres d'emploi et formations par référence, lot, synchronisation, LHEO, sources lues sans développement

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