ELIA CORE AI — Référence API

Ce document constitue la référence technique exhaustive de l'API ELIA CORE AI. Il recense l'intégralité des routes disponibles, regroupées par domaine fonctionnel, et fournit un diagramme d'architecture synthétisant les relations entre groupes. Aucune route n'est inventée : seules les routes effectivement exposées sont documentées.

Root

Point d'entrée racine de l'API. Permet de vérifier que le service répond et d'obtenir les métadonnées de base.

Méthode	Chemin	Description
GET	`/api/`	Point d'entrée racine

Health

Surveillance de l'état opérationnel du service.

Méthode	Chemin	Description
GET	`/api/health`	Vérification de l'état de santé du service

Auth

Gestion de l'authentification locale et fédérée, incluant l'inscription, la connexion, la récupération de mot de passe et l'intégration Google.

Méthode	Chemin	Description
POST	`/api/auth/register`	Inscription d'un nouvel utilisateur
POST	`/api/auth/login`	Connexion par identifiants
POST	`/api/auth/identifier/lookup`	Recherche d'un identifiant existant
POST	`/api/auth/password/forgot`	Demande de réinitialisation de mot de passe
POST	`/api/auth/password/reset`	Réinitialisation effective du mot de passe
POST	`/api/auth/google/session`	Création de session via Google OAuth
GET	`/api/auth/me`	Récupération du profil de l'utilisateur courant
POST	`/api/auth/logout`	Déconnexion et invalidation de session

SSO

Authentification unique (Single Sign-On) via des fournisseurs tiers configurés.

Méthode	Chemin	Description
GET	`/api/auth/sso/providers`	Liste des fournisseurs SSO disponibles
GET	`/api/auth/sso/{provider}/login`	Initialisation du flux SSO pour un fournisseur
GET	`/api/auth/sso/{provider}/callback`	Traitement du callback SSO (GET)
POST	`/api/auth/sso/{provider}/callback`	Traitement du callback SSO (POST)

Security

Administration de la sécurité du compte : sessions actives, historique de connexion, authentification à deux facteurs, clés d'accès, consentements et contrôle d'accès basé sur les rôles.

Méthode	Chemin	Description
GET	`/api/security/overview`	Vue d'ensemble de la sécurité du compte
GET	`/api/security/sessions`	Liste des sessions actives
POST	`/api/security/sessions/{session_id}/revoke`	Révocation d'une session spécifique
POST	`/api/security/sessions/revoke-all`	Révocation de toutes les sessions
GET	`/api/security/login-history`	Historique des connexions
POST	`/api/security/password/change`	Changement de mot de passe
POST	`/api/security/email/change`	Changement d'adresse e-mail
POST	`/api/security/2fa/setup`	Configuration de l'authentification à deux facteurs
POST	`/api/security/2fa/verify`	Vérification du code 2FA
POST	`/api/security/2fa/disable`	Désactivation du 2FA
GET	`/api/security/passkeys`	Liste des clés d'accès (passkeys)
GET	`/api/security/consents`	Liste des consentements enregistrés
POST	`/api/security/consents`	Création ou mise à jour d'un consentement
GET	`/api/security/rbac/roles`	Liste des rôles disponibles
GET	`/api/security/rbac/permissions`	Liste des permissions disponibles
GET	`/api/security/rbac/me`	Rôles et permissions de l'utilisateur courant
POST	`/api/security/rbac/assign`	Attribution d'un rôle à un utilisateur
GET	`/api/security/jurisdiction`	Juridiction associée au compte

Dossier

Gestion du dossier personnel de l'utilisateur : sections, consentements et ligne temporelle des modifications.

Méthode	Chemin	Description
GET	`/api/dossier`	Récupération du dossier complet
PATCH	`/api/dossier/section`	Mise à jour d'une section du dossier
DELETE	`/api/dossier/section/{section}/{index}`	Suppression d'un élément dans une section
POST	`/api/dossier/consent`	Ajout d'un consentement au dossier
GET	`/api/dossier/timeline`	Historique chronologique des modifications du dossier

Identity

Consultation de l'identité vérifiée de l'utilisateur et de son journal d'audit.

Méthode	Chemin	Description
GET	`/api/identity`	Récupération des données d'identité
GET	`/api/identity/audit`	Journal d'audit de l'identité

Collection Engine

Moteur de collecte de données structurées par schémas et sessions guidées, permettant la réponse progressive à des champs sémantiques.

Méthode	Chemin	Description
GET	`/api/collection/schemas`	Liste des schémas de collecte disponibles
GET	`/api/collection/schemas/{key}`	Détail d'un schéma par clé
POST	`/api/collection/session/{schema_key}/start`	Démarrage ou reprise d'une session de collecte
POST	`/api/collection/session/{session_id}/answer`	Soumission d'une réponse dans une session
POST	`/api/collection/session/{session_id}/skip/{field_key}`	Passage d'un champ sans réponse
GET	`/api/collection/session/{session_id}`	État courant d'une session
GET	`/api/collection/answers`	Toutes les réponses de l'utilisateur courant
GET	`/api/collection/answers/{semantic_key:path}/history`	Historique d'une réponse par clé sémantique
POST	`/api/collection/answers/{semantic_key:path}/restore`	Restauration d'une version antérieure de réponse

Timeline

Ligne temporelle des événements et champs, avec résumés analytiques.

Méthode	Chemin	Description
GET	`/api/timeline`	Ligne temporelle globale
GET	`/api/timeline/field`	Ligne temporelle d'un champ spécifique
GET	`/api/timeline/summary`	Résumé de la ligne temporelle

Altiora

Moteur de calcul et d'analyse avancée. Permet de déclencher des calculs, de consulter le dernier résultat et l'historique des analyses.

Méthode	Chemin	Description
POST	`/api/altiora/compute`	Déclenchement d'un calcul Altiora
GET	`/api/altiora/latest`	Dernier résultat de calcul
GET	`/api/altiora/history`	Historique des calculs

Chat

Interface de conversation avec le moteur IA, incluant la gestion des sessions, l'historique et le flux d'embarquement.

Méthode	Chemin	Description
POST	`/api/chat/stream`	Envoi d'un message en mode streaming
GET	`/api/chat/history/{session_id}`	Historique d'une session de chat
GET	`/api/chat/sessions`	Liste des sessions de chat de l'utilisateur
POST	`/api/chat/onboarding/first-question`	Première question du flux d'embarquement

Documents

Gestion du cycle de vie des documents utilisateur : upload, versionnage, consultation et suppression.

Méthode	Chemin	Description
POST	`/api/documents/upload`	Téléversement d'un document
GET	`/api/documents`	Liste des documents de l'utilisateur
GET	`/api/documents/{doc_id}/versions`	Versions d'un document
GET	`/api/documents/{doc_id}`	Récupération d'un document par identifiant
DELETE	`/api/documents/{doc_id}`	Suppression d'un document

OCR

Extraction de texte par reconnaissance optique de caractères sur les documents.

Méthode	Chemin	Description
GET	`/api/ocr/status`	État du service OCR
POST	`/api/ocr/extract`	Extraction OCR d'un document
POST	`/api/ocr/documents/{doc_id}/retry`	Relance de l'extraction OCR pour un document

Generation

Génération de documents finaux (PDF, lettres, attestations, résumés) et soumission à des institutions.

Méthode	Chemin	Description
POST	`/api/generation/pdf`	Génération d'un PDF
POST	`/api/generation/letter`	Génération d'une lettre
POST	`/api/generation/attestation`	Génération d'une attestation en PDF
POST	`/api/generation/summary`	Génération d'un résumé
POST	`/api/generation/submit`	Soumission d'un dossier à une institution
GET	`/api/generation/my-submissions`	Liste des soumissions de l'utilisateur
GET	`/api/generation/institutions`	Liste des institutions disponibles

Output Engine

Moteur de rendu avancé : templates, formats, prévisualisation, rendu synchrone et asynchrone, signature, gestion des limites de débit et des thèmes partenaires.

Méthode	Chemin	Description
GET	`/api/output/templates`	Liste des templates disponibles
GET	`/api/output/formats`	Formats de sortie supportés
POST	`/api/output/preview`	Prévisualisation Markdown
POST	`/api/output/render`	Rendu synchrone d'un document
POST	`/api/output/render/async`	Rendu asynchrone d'un document
GET	`/api/output/jobs`	Liste des jobs de rendu de l'utilisateur
GET	`/api/output/jobs/{job_id}`	État d'un job de rendu
GET	`/api/output/jobs/{job_id}/download`	Téléchargement du résultat d'un job
GET	`/api/output/signing/info`	Informations de signature électronique
GET	`/api/output/rate-limits`	Liste des politiques de limite de débit
POST	`/api/output/rate-limits`	Création ou mise à jour d'une politique
DELETE	`/api/output/rate-limits/{policy_id}`	Suppression d'une politique de limite de débit
GET	`/api/output/rate-limits/breaches`	Historique des dépassements de limite
POST	`/api/output/partner-themes/{partner_id}`	Définition du thème d'un partenaire
GET	`/api/output/partner-themes/{partner_id}`	Récupération du thème d'un partenaire

Partners

Découverte, recommandation et suivi des partenaires, ainsi que gestion des référencements.

Méthode	Chemin	Description
GET	`/api/partners`	Liste des partenaires
GET	`/api/partners/{slug}`	Détail d'un partenaire
POST	`/api/partners/recommend`	Recommandation de partenaires
GET	`/api/partners/{slug}/journey`	Parcours associé à un partenaire
POST	`/api/partners/referral`	Enregistrement d'un référencement
GET	`/api/partners/referral/active`	Référencement actif de l'utilisateur

Partner Hub

Interface de gestion pour les partenaires : profil, soumissions reçues, décisions, messagerie et tableau de bord.

Méthode	Chemin	Description
GET	`/api/hub/me`	Profil du partenaire courant
PATCH	`/api/hub/me`	Mise à jour du profil partenaire
GET	`/api/hub/submissions`	Liste des soumissions reçues
GET	`/api/hub/submissions/{sub_id}`	Détail d'une soumission
POST	`/api/hub/submissions/{sub_id}/decision`	Prise de décision sur une soumission
POST	`/api/hub/submissions/{sub_id}/message`	Envoi d'un message relatif à une soumission
GET	`/api/hub/dashboard`	Tableau de bord partenaire

Institution

Interface dédiée aux institutions pour la réception, l'instruction et la décision sur les dossiers soumis.

Méthode	Chemin	Description
GET	`/api/institution/inbox`	Boîte de réception des soumissions
GET	`/api/institution/submission/{sub_id}`	Détail d'une soumission
POST	`/api/institution/submission/{sub_id}/note`	Ajout d'une note interne
POST	`/api/institution/submission/{sub_id}/decision`	Prise de décision sur une soumission
GET	`/api/institution/dashboard`	Tableau de bord institutionnel

Foliomap Institution

Outil de pilotage de portefeuille pour les institutions : statut, risque, analystes et suivi post-financement.

Méthode	Chemin	Description
GET	`/api/foliomap/status`	Statut du service Foliomap
GET	`/api/foliomap/portfolio`	Vue du portefeuille
GET	`/api/foliomap/risk`	Tableau de bord des risques
GET	`/api/foliomap/analysts`	Liste des analystes
GET	`/api/foliomap/post-financing`	Suivi post-financement

Opportunities

Détection et gestion des opportunités de financement ou d'accompagnement, avec préparation contextuelle.

Méthode	Chemin	Description
GET	`/api/opportunities`	Liste des opportunités
POST	`/api/opportunities/refresh`	Actualisation des opportunités
PATCH	`/api/opportunities/{opp_id}`	Mise à jour du statut d'une opportunité
GET	`/api/opportunities/preparation`	Préparation globale aux opportunités
POST	`/api/opportunities/preparation/refresh`	Actualisation de la préparation
POST	`/api/opportunities/preparation/{objective_key}`	Préparation ciblée par objectif

Copilot

Pilotage du cycle de vie utilisateur avec gestion des étapes, des transitions et de l'automatisation.

Méthode	Chemin	Description
GET	`/api/copilot/dashboard`	Tableau de bord du copilote
GET	`/api/copilot/lifecycle/stages`	Étapes du cycle de vie
POST	`/api/copilot/lifecycle/transition`	Déclenchement d'une transition
POST	`/api/copilot/lifecycle/auto`	Activation ou désactivation de l'automatisation

Plans

Gestion des abonnements, des paiements et des changements de plan.

Méthode	Chemin	Description
GET	`/api/plans`	Liste des plans disponibles
GET	`/api/plans/me`	Plan actif de l'utilisateur
POST	`/api/plans/checkout`	Initialisation d'un paiement
GET	`/api/plans/payment/status/{session_id}`	Statut d'une session de paiement
POST	`/api/plans/change-plan`	Changement de plan

Payments

Consultation des fournisseurs de paiement et de leur état opérationnel.

Méthode	Chemin	Description
GET	`/api/payments/providers`	Liste des fournisseurs de paiement
GET	`/api/payments/providers/status`	État des fournisseurs de paiement

Stripe Webhook

Réception des événements Stripe pour le traitement des paiements asynchrones.

Méthode	Chemin	Description
POST	`/api/stripe/webhook`	Réception d'un événement webhook Stripe

Agenda

Gestion des tâches et de l'agenda de l'utilisateur, avec génération automatique et résumé.

Méthode	Chemin	Description
GET	`/api/agenda`	Liste des tâches
POST	`/api/agenda/generate`	Génération automatique de tâches
POST	`/api/agenda`	Création manuelle d'une tâche
PATCH	`/api/agenda/{task_id}`	Mise à jour d'une tâche
GET	`/api/agenda/summary`	Résumé de l'agenda

Notifications

Gestion des notifications utilisateur avec marquage de lecture individuel et global.

Méthode	Chemin	Description
GET	`/api/notifications`	Liste des notifications
POST	`/api/notifications/{notif_id}/read`	Marquage d'une notification comme lue
POST	`/api/notifications/mark-all-read`	Marquage de toutes les notifications comme lues

Providers

Référentiel des fournisseurs de services tiers disponibles sur la plateforme.

Méthode	Chemin	Description
GET	`/api/providers/status`	État global des fournisseurs
GET	`/api/providers`	Liste des fournisseurs
GET	`/api/providers/{slug}`	Détail d'un fournisseur

Media

Gestion des ressources médias : upload, consultation, téléchargement, liens d'accès et journaux.

Méthode	Chemin	Description
POST	`/api/media/upload`	Téléversement d'une ressource média
GET	`/api/media/assets`	Liste des ressources médias
GET	`/api/media/assets/{asset_id}`	Détail d'une ressource
GET	`/api/media/assets/{asset_id}/download`	Téléchargement d'une ressource
DELETE	`/api/media/assets/{asset_id}`	Suppression d'une ressource
GET	`/api/media/assets/{asset_id}/access-logs`	Journal d'accès à une ressource
POST	`/api/media/assets/{asset_id}/links`	Création d'un lien d'accès
DELETE	`/api/media/links/{token}`	Révocation d'un lien d'accès

Media Public

Accès public aux ressources médias via un jeton de partage.

Méthode	Chemin	Description
GET	`/api/media/public/{token}`	Consultation publique d'une ressource par jeton

Field Evidence

Liaison entre assets médias et entités métier pour la constitution de preuves documentaires.

Méthode	Chemin	Description
POST	`/api/field/links`	Création d'un lien entité-asset
DELETE	`/api/field/links`	Suppression d'un lien entité-asset
GET	`/api/field/entities/{entity_type}/{entity_id}/assets`	Assets liés à une entité
GET	`/api/field/assets/{asset_id}/entities`	Entités liées à un asset

Location

Collecte et consultation des données de position géographique, avec résolution IP et journaux d'accès.

Méthode	Chemin	Description
POST	`/api/location/positions`	Enregistrement d'une position
GET	`/api/location/positions/last`	Dernière position enregistrée
GET	`/api/location/positions/history`	Historique des positions
GET	`/api/location/access-logs`	Journal d'accès aux données de localisation
GET	`/api/location/resolve-ip`	Résolution d'adresse IP en localisation
GET	`/api/location/sources`	Sources de localisation disponibles

Knowledge Center

Base de connaissances complète : gestion des documents, catégories, audiences, versions, export, traductions, génération automatique de contenu et liens d'accès.

Méthode	Chemin	Description
GET	`/api/kb/categories`	Liste des catégories
GET	`/api/kb/documents`	Liste des documents
GET	`/api/kb/documents/{slug}`	Détail d'un document
GET	`/api/kb/documents/{slug}/versions`	Versions d'un document
GET	`/api/kb/documents/{slug}/export`	Export d'un document
GET	`/api/kb/search`	Recherche dans la base de connaissances
GET	`/api/kb/status`	État du service
GET	`/api/kb/generation/profiles`	Profils de génération de contenu
GET	`/api/kb/generation/snapshot`	Snapshot de génération
POST	`/api/kb/generation/run`	Lancement d'une génération de contenu
GET	`/api/kb/jobs/{job_id}`	État d'un job de génération
GET	`/api/kb/jobs`	Liste des jobs de génération
GET	`/api/kb/languages`	Langues disponibles
POST	`/api/kb/languages`	Ajout d'une langue
PATCH	`/api/kb/languages/{code}`	Activation ou désactivation d'une langue
POST	`/api/kb/translations/run`	Lancement d'une traduction
GET	`/api/kb/translations`	Liste des traductions
POST	`/api/kb/translations/{translation_id}/approve`	Approbation d'une traduction
POST	`/api/kb/translations/{translation_id}/reject`	Rejet d'une traduction
GET	`/api/kb/audiences`	Liste des audiences
POST	`/api/kb/audiences`	Création d'une audience
PATCH	`/api/kb/audiences/{slug}`	Modification d'une audience
PUT	`/api/kb/documents/{slug}/audiences`	Association d'audiences à un document
POST	`/api/kb/documents/{slug}/make-private`	Passage d'un document en accès privé
POST	`/api/kb/documents/{slug}/links`	Création d'un lien d'accès
DELETE	`/api/kb/links/{token}`	Révocation d'un lien d'accès
GET	`/api/kb/documents/{slug}/access-logs`	Journal d'accès à un document

Knowledge Public

Accès public à la base de connaissances, filtré par audience et par lien de partage.

Méthode	Chemin	Description
GET	`/api/kb/public/audiences`	Audiences publiques disponibles
GET	`/api/kb/public/{audience_slug}/documents`	Documents publics par audience
GET	`/api/kb/public/{audience_slug}/documents/{slug}`	Document public par audience et slug
GET	`/api/kb/public/link/{token}`	Accès à un document via lien de partage
GET	`/api/kb/public/link/{token}/export`	Export d'un document via lien de partage

API Reference — vue complète et à jour