Pour les développeurs
API Owlic : branche tes logiciels préférés sur Owlic
Ton CRM, ton LMS ou ton agent IA connaissent déjà tes sessions de formation. L’API Owlic les synchronise dans Owlic, sans ressaisie : conventions, convocations, émargements et dossier Qualiopi se préparent à partir de là.

Ce que tu peux faire avec l’API
Actions de formation
Crée-les, liste-les, et renseigne chaque étape : analyse du besoin, bénéficiaires, programme, sessions, formateurs, tarif, convention.
Identité
Vérifie la clé utilisée et l’organisation à laquelle elle donne accès.
Programmes de formation
Garde ton catalogue synchronisé avec ton site ou ton LMS : modules, formateurs, positionnement, évaluation.
Formateurs
Retrouve les intervenants rattachés à ton organisme.
Démarrer en 3 minutes
1 Crée une clé API
Dans l’administration de ton organisation, rubrique Clés API. Elle commence par owlic_sk_ : garde-la côté serveur.
2 Installe le SDK
npm install @owlic/sdk
3 Fais ton premier appel
import { Owlic } from '@owlic/sdk';
const owlic = new Owlic({ apiKey: process.env.OWLIC_API_KEY });
const me = await owlic.whoami();
console.log(me.organizationId);

Le SDK TypeScript @owlic/sdk
- Typé de bout en bout : ses types viennent du même contrat que l’OpenAPI : chaque appel est vérifié à la compilation.
-
Léger : une fine couche au-dessus de
fetch, compatible Node.js 18+, edge, Bun et Deno. -
Pensé pour la prod : reprises automatiques avec backoff (qui respectent
Retry-After), pagination par itération asynchrone, erreurs typées (NotFoundError,RateLimitError…). - Sûr par défaut : il refuse de tourner dans un navigateur, pour que ta clé ne se retrouve pas exposée.
Tu n’es pas en TypeScript ?
Toute l’API se consomme en HTTP classique, avec Authorization: Bearer <clé> ou X-Api-Key.
Ressources utiles
Référence de l’API
Spécification OpenAPI 3.1
Package
sur npm
Découvre notre application
pour centraliser et suivre tes preuves Qualiopi sans prise de tête.
Pour les agents IA
- Le contrat OpenAPI 3.1 est lisible par machine : un agent peut l’importer tel quel comme ensemble d’outils.
- Chaque page du site existe en Markdown : envoie
Accept: text/markdown. - llms.txt présente Owlic et liste ses pages.
Versions et limites v1
L’API est versionnée dans l’URL (/v1)
Tout changement incompatible passera par une nouvelle version : /v1 reste stable.
60 requêtes par tranche de 10 secondes.
Chaque réponse indique ton quota restant dans les en-têtes RateLimit et RateLimit-Policy. Au-delà, l’API répond 429 : le SDK attend et réessaie tout seul, sauf les créations (POST), pour ne jamais créer de doublon.
Une question ?
Un humain de l’équipe te répond.