Aller au contenu

Retour à la formule Pro Formation

Pro Formation

L’API Formation

Vos formations publiées depuis votre site ou votre logiciel, et tenues à jour toutes seules

Vous ajoutez, modifiez ou retirez une formation chez vous : heyalink fait la même chose sur votre page pro. Vous ne saisissez rien deux fois.

Profiter de Pro Formation à -50 %

-50 % sur votre premier mois, puis 149 € HT par mois, sans engagement

Lire la documentation technique

Deux façons de publier vos formations

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

À la main

Sur votre page pro, rubrique Formation : « Publier une formation ». Vous remplissez la fiche, elle paraît. Pratique pour quelques formations.

Avec toutes les formules

Automatiquement, par l’API Formation

Votre site ou votre logiciel envoie vos formations à heyalink. Quand vous ajoutez, modifiez ou retirez une formation chez vous, ou la déclarez complète, heyalink fait de même.

Comprise dans Pro Formation Grands comptes

Ce que l’API change pour vous

  • Une seule saisie

    Vos formations vivent dans votre logiciel. heyalink les reprend telles quelles.

  • Toujours à jour

    Une session complète sort de heyalink. Une formation retirée chez vous l’est aussi sur heyalink.

  • Mieux trouvées

    Financements, CPF, RNCP, alternance, niveau : vos formations entrent dans les filtres de la rubrique Formation.

  • Vous gardez la main

    Chaque appel est noté dans un journal. Une clé se coupe en un clic.

Trois façons de brancher votre catalogue

  1. Sans développement : l’adresse de votre catalogueVous donnez l’adresse de votre catalogue au format LHEO, celui des Carif-Oref, ou en JSON. heyalink le relit tout seul : toutes les 10 minutes au plus vite, toutes les 6 heures au plus tard.
  2. Votre catalogue envoyé en un appelVotre logiciel envoie le fichier LHEO à heyalink, 5 Mo au plus. Les formations absentes du fichier peuvent être archivées du même coup.
  3. L’API, formation par formationVotre logiciel envoie chaque formation en JSON. Un assistant IA peut le faire aussi, par le serveur MCP.

Ce que fait l’API Formation

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

Ce que fait l’API 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 formations

  • Les webhooksheyalink prévient votre site par un appel signé quand une formation est en ligne, en attente, masquée par la modération, passée, archivée, complète, fermée, rouverte, supprimée ou refusée sur une photo ou un PDF. 5 adresses au plus.
  • Le journalLes derniers appels et leur résultat, gardés 90 jours. Lisible aussi sur l’écran API Formation.
  • La preuve de votre siteVous prouvez que le site de vos formations est le vôtre, par une balise ou un fichier. Personne ne publie en votre nom.
  • La clé d’essaiLes mêmes réponses qu’une vraie clé, sans rien publier. Les formations 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é.
  • Le serveur MCPVos assistants IA listent, publient, archivent et retirent vos formations.
  • OAuth 2.0Pour les logiciels qui le préfèrent : votre clé s’échange contre un jeton de 60 minutes.
  • La vérification de la cléUn appel dit à quelle page pro la clé appartient et ce qu’elle a le droit de faire.
  • L’état de l’APIUn appel public, sans clé.

Les informations d’une formation

Trois sont obligatoires. Les autres rangent mieux vos formations dans les recherches et les filtres.

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.

L’image d’une formation s’ajoute sur heyalink : elle ne passe pas par l’API.

Comment obtenir l’accès

L’API Formation est comprise dans ces formules : Pro Formation Grands comptes

La page pro gratuite et le Pro ne l’ont pas.

  1. Abonnez votre page pro à Pro FormationL’accès s’ouvre dès que la formule est en cours.
  2. Ouvrez l’écran API FormationRubrique Formation, « Mes formations » : « Connecter mes formations automatiquement ». Le titulaire et les administrateurs de la page pro y ont accès.
  3. Créez une clé ou invitez votre prestataireJusqu’à 10 clés actives, une par logiciel. Vous pouvez aussi inviter 5 développeurs au plus : ils ne voient que l’écran API et leurs propres clés.
  4. Prouvez votre site, puis publiezUne balise ou un fichier sur votre site suffit. Ensuite, vos formations paraissent.

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 site ou votre logiciel. La documentation se lit sans compte, même avant de vous abonner.

Adresse
https://heyalink.com/api/formation/v1
Format
JSON en UTF-8 ; LHEO en XML pour le catalogue
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, pour l’API Formation seule
Limite
300 appels par minute et par clé, 60 avec une clé d’essai
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 catalogue a déjà une adresse LHEO ou JSON, vous la collez sur l’écran API Formation et vous ajoutez sur votre site la balise ou le fichier qui prouve qu’il est à vous. Pour l’API, la personne qui gère votre site s’en charge avec la documentation.

Puis-je publier à la main et par l’API ?

Oui. L’API ne touche que les formations qu’elle a publiées. Celles saisies à la main restent comme elles sont.

Les formations de l’API comptent-elles dans ma formule ?

Oui, comme les autres : 10 comprises avec Pro Formation, puis chaque formation en plus coûte 10 € HT par mois jusqu’à la 20e, 5 € de la 21e à la 50e, 2 € au-delà.

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.

Pro Formation

Votre catalogue publié tout seul, dès ce mois-ci

149 € HT par mois, sans engagement · -50 % sur le premier mois

Profiter de Pro Formation à -50 %

-50 % sur votre premier mois, puis 149 € HT par mois, sans engagement

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