Connecteur

Qualiobee

Connecteur implémenté comme un adaptateur REST générique : base d'URL et chemins configurables, à valider contre l'API réelle de Qualiobee.

Ce que l'organisme fournit

Un jeton API Bearer Qualiobee avec accès en lecture aux stagiaires, collé dans /connectors.

Configuration

Base d'URL via la variable QUALIOBEE_API_URL, en-tête Authorization: Bearer <token>. Sans configuration, le connecteur renvoie une erreur explicite.

GET {QUALIOBEE_API_URL}/trainees
Authorization: Bearer <token>
Accept: application/json

Réponse supportée

Tableau direct ou enveloppe { data: [...] }. Les variantes de noms de champs (first_name/firstname) sont tolérées.

{
  "data": [
    { "id": "abc", "first_name": "Marie", "last_name": "Martin",
      "email": "marie@ex.fr", "phone": "0601020304" }
  ]
}

Mapping vers le contrat Rappel Forma

Fichier src/lib/connectors/qualiobee.ts :

list.map((t) => ({
  externalId: String(t.id),
  firstName: t.first_name ?? t.firstname,
  lastName: t.last_name ?? t.lastname,
  email: t.email ?? null,
  phone: t.phone ?? null,
  trainings: [],
}));

À valider / à compléter

La base d'URL, les chemins (/trainees…), le mode d'authentification et les noms de champs doivent être confirmés sur l'API réelle de Qualiobee. Le rattachement des formations/sessions suit la même logique que Digiforma (mapping vers certification_types.code + obtainedDate).