Digiforma

Ce que l'organisme fournit

Un jeton API Bearer Digiforma avec accès en lecture aux stagiaires (généré dans l'espace Digiforma). C'est la seule information à coller dans /connectors.

Endpoint & authentification

Endpoint GraphQL (configurable via la variable d'environnement DIGIFORMA_GRAPHQL_URL), en-tête Authorization: Bearer <token>.

POST {DIGIFORMA_GRAPHQL_URL}
Authorization: Bearer <token>
Content-Type: application/json

Requête exécutée

Récupération des stagiaires :

query {
  trainees {
    id
    firstname
    lastname
    email
    phone
  }
}

Réponse attendue

{
  "data": {
    "trainees": [
      { "id": 123, "firstname": "Jean", "lastname": "Dupont",
        "email": "jean@ex.fr", "phone": "0612345678" }
    ]
  }
}

Mapping vers le contrat Rappel Forma

Fichier src/lib/connectors/digiforma.ts :

trainees.map((t) => ({
  externalId: String(t.id),
  firstName: t.firstname,
  lastName: t.lastname,
  email: t.email ?? null,
  phone: t.phone ?? null,
  trainings: [],   // rattachement des sessions : itération suivante
}));

À valider / à compléter

Les noms de champs GraphQL doivent être confirmés contre le schéma réel (explorateur GraphiQL du compte). Le rattachement des formations/sessions (pour pré-remplir les certifications et leurs échéances) est la prochaine itération : il faut récupérer les sessions du stagiaire et mapper chaque formation vers un certification_types.code et une obtainedDate.