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

Code source sur GitHub

(licence MIT)

Découvre notre application

pour centraliser et suivre tes preuves Qualiopi sans prise de tête.

  • 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.

Tout changement incompatible passera par une nouvelle version : /v1 reste stable.

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.