Menu

Nouveau · API Loop

Branchez Loop à tous vos outils.

L'API Loop ouvre votre espace à Zapier, n8n, Make, à votre site, à votre CRM ou à votre outil de pilotage. Lisez et écrivez vos apprenants, sessions, inscriptions et affaires, et recevez un événement signé dès qu'une fiche change — que la modification vienne d'un outil branché ou de votre équipe dans Loop.

La documentation est déjà dans votre espace https://<votre-espace>/global_api/v1/docs 17 sections · OpenAPI
  • 22 ressources
  • Simulation avant écriture
  • Événements signés
  • Compatible Zapier, n8n et Make
Événements livraisons signées
Loop événements Zapier 200 n8n 200 Make 200 CRM 200 Site web 200
  1. 09:12:44 inscriptions.creee → Zapier 200
  2. 09:12:41 affaires.modifiee → CRM 200
  3. 09:12:37 sessions.etat_modifie → n8n 200
Illustration : trois requêtes types — lire, simuler une écriture, s'abonner — et les événements que Loop envoie aux outils branchés.

Le principe

Une clé, une requête, des événements

Trois notions suffisent pour tout brancher. Le reste — pagination, contrôles, réessais — Loop s'en occupe.

  1. 01

    Créez une clé

    Un administrateur la crée dans la fiche organisme et choisit ses portées, ressource par ressource : lecture, écriture, ou les deux. Elle n'est affichée qu'une fois.

    Authorization: Bearer lfk_live_…
  2. 02

    Envoyez une requête

    Une adresse par ressource, du JSON à l'aller comme au retour. Recherche, filtres par date et pagination par curseur fonctionnent partout de la même façon.

    GET /global_api/v1/apprenants?q=dupontGET /global_api/v1/affaires?cursor=104701
  3. 03

    Abonnez-vous aux événements

    Indiquez une adresse et les événements qui vous intéressent : Loop l'appelle dès qu'une fiche est créée, modifiée, change d'état ou est supprimée.

    POST /global_api/v1/webhooks{ "url": "https://…", "events": ["inscriptions.creee"] }
  • 22ressources, de l'apprenant au catalogue
  • 39erreurs numérotées, chacune avec sa cause et son remède
  • ≈ 0,26 spour parcourir 10 000 affaires
  • 8réessais au maximum pour livrer un événement

Cas d'usage

Ce que l'on branche en premier

Six scénarios concrets, réalisables avec Zapier, n8n, Make ou quelques lignes de code.

  • Formulaire du site → affaire dans Loop

    Chaque demande envoyée depuis votre site crée une affaire dans votre pipeline commercial, avec son contact. Plus de ressaisie, plus de demande oubliée dans une boîte mail.

    site web POST /v1/affaires
  • Nouvelle inscription → message d'équipe

    Via Zapier ou n8n, votre équipe est prévenue dans Slack ou Teams dès qu'un apprenant est inscrit — y compris quand l'inscription est saisie à la main dans Loop.

    inscriptions.creee Zapier Slack
  • Tableau de bord BI

    Sessions, factures, échéances et affaires alimentent votre outil de pilotage page après page, avec les seules fiches modifiées depuis la dernière synchronisation.

    GET /v1/factures?updated_since=… BI
  • Synchronisation d'un CRM externe

    Contacts, entreprises et affaires restent alignés entre Loop et votre CRM : lecture, écriture et événements pour que chaque changement se propage.

    affaires.modifiee CRM
  • Leads de landing page → outil marketing

    Les contacts recueillis par vos landing pages Loop, et leurs statistiques, partent vers votre outil d'e-mailing ou de marketing automation.

    GET /v1/landing-pages/{id}/leads
  • Quiz et progression e-learning → outil RH

    Résultats de quiz et progression e-learning de chaque inscrit remontent dans le système RH de l'entreprise cliente ou dans vos bilans.

    GET /v1/inscriptions/{id}/elearning

Ressources

22 ressources, les mêmes règles partout

Chaque ressource a son adresse, ses champs, ses filtres et ses droits. Ce que l'API peut modifier est exactement ce qu'il est sûr de modifier depuis l'extérieur.

Écriturecréer, modifier, supprimer Modificationmodifier seulement
  • Apprenants /v1/apprenants Lecture Écriture
  • Entreprises /v1/entreprises Lecture Écriture
  • Contacts /v1/contacts Lecture Écriture
  • Formateurs /v1/formateurs Lecture Écriture
  • Programmes /v1/programmes Lecture Écriture
  • Inscriptions apprenants /v1/inscriptions Lecture Écriture
  • Inscriptions entreprises /v1/inscriptions-entreprises Lecture Écriture
  • Interventions formateurs /v1/interventions Lecture Écriture
  • Affaires /v1/affaires Lecture Écriture
  • Lieux /v1/lieux Lecture Écriture
  • Salles /v1/salles Lecture Écriture
  • Tâches /v1/taches Lecture Écriture
  • Sessions /v1/sessions Lecture Modification
  • Factures /v1/factures Lecture seule
  • Échéances /v1/echeances Lecture seule
  • Formulaires /v1/formulaires Lecture seule
  • Réponses /v1/reponses Lecture seule
  • Modèles de parcours /v1/modeles-parcours Lecture seule
  • Résultats de quiz /v1/resultats-quiz Lecture seule
  • Dépôts de quiz /v1/depots-quiz Lecture seule
  • Landing pages /v1/landing-pages Lecture seule
  • Catalogues /v1/catalogues Lecture seule

Les sessions se modifient par l'API mais se créent dans Loop. Les factures restent en lecture : elles partent automatiquement en comptabilité. Voir la passerelle Pennylane →

Lire vos données

  • Pagination par curseur avec cursor et limit : stable, même sur de gros volumes.
  • Recherche libre q et filtres de date updated_since, created_since : la base de toute synchronisation régulière.
  • ?champs_specifiques=1 renvoie les champs spécifiques créés par votre organisme, avec leur libellé et leur section.
  • ?tous_les_champs=1 ajoute le reste de la fiche : réponses de formulaire, colonnes conservées lors d'un import.
  • Les mots de passe et les jetons de service ne sortent jamais, quel que soit le réglage.
≈ 0,26 s pour paginer 10 000 affaires, du premier au dernier curseur.

Suivi et statistiques

  • GET/v1/sessions/{id}/elearningProgression e-learning d'une session
  • GET/v1/inscriptions/{id}/elearningProgression e-learning d'un inscrit
  • GET/v1/formulaires/{id}/statistiquesStatistiques d'un formulaire
  • GET/v1/landing-pages/{id}/leadsContacts recueillis par une landing page
  • GET/v1/landing-pages/{id}/statistiquesStatistiques d'une landing page
  • GET/v1/catalogues/{id}/formationsFormations publiées dans un catalogue
  • GET/v1/sessions?formation={id}Sessions d'une formation
  • GET/v1/filtres · /v1/statistiquesFiltres disponibles et indicateurs de l'organisme

Le catalogue public accepte aussi une clé API portant la portée catalogues:read.

Écrire sans risque

Écrire dans Loop, sans mauvaise surprise

Un outil qui écrit dans votre gestion de formation doit être plus prudent qu'un humain. L'API Loop l'est par construction.

  • ?simulation=1

    Simulation

    Sur une création, une modification ou une suppression : toutes les règles sont vérifiées, la réponse montre ce qui serait écrit et ce que Loop ferait en plus. Rien n'est enregistré.

  • Idempotency-Key

    Rejeu sans doublon

    Un envoi rejoué dans les 24 heures — coupure réseau, relance automatique — renvoie la première réponse au lieu de créer une seconde fiche.

  • DELETE → corbeille

    Suppression réversible

    Une suppression place la fiche à la corbeille. Elle se récupère comme n'importe quelle fiche supprimée dans Loop.

  • LOOP-1xxx

    Refus expliqués

    Chaque refus donne un code stable, un message, la cause, le remède et le paramètre concerné.

Un refus qui explique. Les 39 erreurs de l'API suivent la même forme : votre scénario sait quoi faire, votre équipe comprend pourquoi.

Les mêmes automatismes que dans Loop

  • Numérotation automatique appliquée, organisme et auteur renseignés : la fiche ressemble à une fiche créée dans Loop.
  • Inscrire un apprenant à une session inscrit aussi son entreprise si besoin — signalé dans actions_complementaires.
  • Bloc financements complet en lecture et en écriture : OPCO, CPF, France Travail, entreprise, financement personnel — montant, pourcentage, financeur, numéros de dossier et de contrat. Total contrôlé, jamais plus de 100 %.
  • Rémunération des formateurs sur leurs interventions : forfait, temps passé, frais.
  • creer_champs_manquants: true crée le champ spécifique manquant, puis y écrit la valeur.
  • Aucun e-mail envoyé, aucun compte de connexion créé par l'API.

39 erreurs, rangées par famille

  • 10xxAccès
  • 11xxRequête
  • 12xxChamps
  • 13xxLiens entre fiches
  • 14xxRègles métier
  • 15xxLimites
  • 19xxService
Quelques exemples
  • LOOP-1401Apprenant déjà inscrit à cette session.
  • LOOP-1405SIRET déjà pris — contournable par autoriser_doublon.
  • LOOP-1410Dates incohérentes : la fin précède le début.
  • LOOP-1412Somme des financements supérieure à 100 %.
  • LOOP-1301La fiche liée n'existe pas.
  • LOOP-1302La fiche liée appartient à un autre organisme.
  • LOOP-1303La fiche liée n'est pas du bon type.
L'API se décrit elle-même
/v1/erreursLe catalogue complet des erreurs, lisible par programme.
/v1/valeursLes valeurs autorisées, y compris les listes configurées par votre organisme.
/v1/schema/<ressource>Champs, champs spécifiques réels avec leur identifiant, obligatoires, règles en clair — et un exemple de création avec de vrais identifiants de votre organisme.

Événements · webhooks

Loop vous prévient dès qu'une fiche change

Abonnez n'importe quelle adresse aux événements de vos ressources avec POST /v1/webhooks. Chaque envoi transporte la fiche complète et une signature.

<ressource>.creeeUne fiche vient d'être créée.
<ressource>.modifieeUne information de la fiche a changé.
<ressource>.etat_modifieLa fiche a changé d'état ou d'étape.
<ressource>.supprimeeLa fiche a été supprimée.
<ressource>.lot_termineUn traitement en masse a touché plus de 200 fiches : un seul événement.
  • Les événements partent aussi quand votre équipe agit à la main dans Loop, pas seulement quand l'API écrit.
  • Import de plus de 200 fiches : un unique événement de fin de lot, pour ne pas saturer vos scénarios.
  • Aucun coût ni ralentissement tant qu'aucun abonnement n'existe.
  • Abonnements visibles dans Loop : filtres, pause et reprise, compteurs et historique des envois.
Un événement signé. La fiche complète voyage avec l'événement, et la signature prouve qu'il vient de Loop.

Votre outil ne répond pas ? Loop réessaie.

Jusqu'à 8 réessais, de plus en plus espacés.
  • Chaque échec reporte l'envoi, sans rien perdre ni bloquer votre espace.
  • Livrés, en attente, abandonnés : chaque abonnement a ses compteurs et son historique.
  • Une pause arrête les envois ; une reprise ne rejoue pas d'un coup des événements périmés.

Documentation

Une documentation qui connaît votre espace

Métier et technique à la fois, à l'adresse /global_api/v1/docs de votre espace. Collez votre clé : les champs, les valeurs autorisées et les exemples deviennent les vôtres.

La documentation, dans votre espace. Chaque ressource se déplie : adresses, champs, règles — et trois boutons pour lire pour de vrai, copier un exemple ou simuler une écriture.
  • 17 sections, métier et technique

    À quoi ça sert, cas d'usage, démarrage, clés, ressources, lecture, écriture, suivi, erreurs, événements, Zapier, n8n, recettes, sécurité, console.

  • Un sommaire qui vous suit

    Le sommaire latéral suit le défilement : vous savez toujours où vous êtes dans la page.

  • Votre clé, vos données

    Collez votre clé en haut de page : la documentation affiche vos champs spécifiques et vos valeurs autorisées.

  • Essayer

    Une vraie lecture sur votre espace, depuis la page, sans outil à installer.

  • Exemple et Simuler

    Un corps prêt à copier avec des valeurs fictives, ou une vraie requête envoyée en mode simulation.

  • OpenAPI et guide utilisateur

    La spécification openapi.json se télécharge ; un chapitre API figure dans le guide utilisateur de Loop.

Clés et sécurité

Vos clés, vos règles, votre journal

L'écran « API Loop » de la fiche organisme, dans Intégrations puis Connecteurs, rassemble les clés et les abonnements. Il est réservé aux administrateurs.

Clés et abonnements, au même endroit. Portées visibles d'un coup d'œil, clé masquée, pause et reprise en un clic, et l'historique de chaque livraison.
  • Empreinte seulement

    La clé complète s'affiche une fois. Loop n'en conserve qu'une empreinte : elle n'est plus lisible ensuite, par personne.

  • Portées par ressource

    Lecture ou écriture, ressource par ressource, avec des jokers si besoin. Une clé ne fait que ce que vous avez autorisé.

  • Quota par minute

    Au-delà, la réponse 429 demande d'attendre : un scénario qui s'emballe ne pénalise pas votre espace.

  • Adresses IP autorisées

    Restreignez une clé aux serveurs de votre outil : utilisée ailleurs, elle est refusée.

  • Cloisonnement strict

    Une clé ne voit que son organisme. Une fiche d'un autre organisme est refusée avec l'erreur LOOP-1302.

  • Journal des appels

    Chaque appel est tracé : vous savez quel outil a fait quoi, et quand.

  • Connexion OAuth

    Pour les applications : l'accès s'autorise en un clic, sans copier de clé.

  • Réservé aux administrateurs

    Création, désactivation et suppression des clés et des abonnements restent entre leurs mains.

Connecteurs

Zapier, n8n, Make — ou votre propre code

L'API suit des conventions standard : les outils d'automatisation s'y branchent avec leurs briques habituelles.

  • Zapier

    Abonnements aux événements compatibles Zapier (REST hooks) et connexion OAuth : un déclencheur « nouvelle inscription » se relie sans copier de clé.

    inscriptions.creee → Slack, Teams, Sheets…
  • n8n

    Un nœud Webhook abonné aux événements Loop, des nœuds HTTP Request avec votre clé pour lire et écrire. La documentation lui consacre un chapitre.

    Authorization: Bearer lfk_live_…
  • Make

    Un webhook personnalisé pour recevoir les événements, le module HTTP pour appeler les ressources. Les recettes de la documentation s'appliquent telles quelles.

    POST /global_api/v1/webhooks
  • Votre code

    Site, CRM, outil de BI ou développement maison : du JSON, une spécification OpenAPI à importer, des erreurs lisibles par programme.

    GET /global_api/v1/openapi.json

Questions fréquentes

L'API Loop en clair

À quoi sert l'API Loop ?

Elle permet de piloter votre espace Loop depuis un autre outil : lire et écrire vos apprenants, entreprises, sessions, inscriptions, affaires ou tâches, et être prévenu quand une fiche change. C'est ce qui relie Loop à Zapier, n8n, Make, à votre site, à votre CRM ou à vos tableaux de bord.

Faut-il être développeur pour l'utiliser ?

Pas pour les usages courants : avec Zapier, n8n ou Make, vous assemblez des scénarios sans écrire de code, à partir de votre clé et des événements Loop. La documentation s'adresse aux deux publics, avec une partie métier (à quoi ça sert, cas d'usage, recettes) et une partie technique complète.

Où se trouve la documentation ?

Dans votre espace, à l'adresse /global_api/v1/docs. Collez votre clé dans la barre en haut de page : la documentation affiche alors vos propres champs spécifiques et vos valeurs autorisées, et chaque ressource peut être essayée. La spécification OpenAPI est téléchargeable, et un chapitre dédié figure dans le guide utilisateur de Loop.

Comment obtenir une clé ?

Un administrateur la crée dans la fiche organisme, rubrique Intégrations puis Connecteurs, et choisit ce qu'elle a le droit de faire, ressource par ressource. La clé n'est affichée qu'une fois : Loop n'en conserve qu'une empreinte. Pour les applications, une connexion OAuth évite même de copier une clé.

Peut-on tester une écriture sans rien modifier ?

Oui. Ajoutez ?simulation=1 à une création, une modification ou une suppression : Loop vérifie toutes les règles et renvoie ce qui serait écrit, avec les actions complémentaires qu'il déclencherait, sans rien enregistrer. Seule exception, signalée dans la réponse : la création de champs spécifiques manquants demandée avec creer_champs_manquants. Le bouton Simuler de la documentation fait la même chose.

Que se passe-t-il si une requête est envoyée deux fois ?

Avec l'en-tête Idempotency-Key, un envoi rejoué dans les 24 heures renvoie la première réponse au lieu de créer une seconde fiche. Et un apprenant déjà inscrit à une session ou une adresse e-mail déjà utilisée sont refusés avec une erreur explicite (LOOP-1401, LOOP-1404).

Les événements partent-ils aussi quand mon équipe travaille dans Loop ?

Oui. Une fiche créée, modifiée ou changée d'état à la main dans Loop déclenche les mêmes événements qu'une action faite par l'API. Lors d'un traitement de plus de 200 fiches, comme un import, un seul événement de fin de lot est envoyé.

Comment vérifier qu'un événement vient bien de Loop ?

Chaque envoi porte l'en-tête X-Loop-Signature, calculé en HMAC-SHA256 avec le secret remis à la création de l'abonnement. Si votre outil ne répond pas, Loop réessaie jusqu'à 8 fois à intervalles espacés, et l'historique de chaque abonnement montre ce qui a été livré, ce qui attend et ce qui a été abandonné.

Mes données sont-elles protégées ?

Chaque clé est cloisonnée à votre organisme, limitée à ses portées, soumise à un quota par minute et, si vous le souhaitez, à une liste d'adresses IP autorisées. Tous les appels sont journalisés, et les données sensibles comme les mots de passe ne sortent jamais. Les factures restent en lecture seule : elles partent automatiquement en comptabilité.

Est-ce compatible avec Zapier, n8n et Make ?

Oui. Les abonnements aux événements suivent le modèle REST hooks utilisé par Zapier, et une connexion OAuth permet de relier un compte sans copier de clé. n8n et Make se branchent avec leurs modules HTTP et webhook habituels, et la documentation propose des recettes prêtes à l'emploi.

GET/global_api/v1/docs

Branchez votre premier outil.

Créez votre espace, générez une clé, ouvrez la documentation : votre première requête part en quelques minutes, et un expert Loop peut vous accompagner sur vos scénarios.

WhatsApp +33 9 78 45 08 49 Contact Démo gratuite