Aller au contenu

Lecture automatique de documents

Cette page publie les trois opérations d'administration Mercure/LAD. Elles exigent l'authentification REST et le privilège admin_mercure.

Pour la configuration fonctionnelle, consultez le guide LAD.

Tester l'installation LAD

POST /rest/administration/mercure/test

Le contrôleur crée une configuration locale désactivée si elle est absente, vérifie l'installation Mercure, génère un PDF de test puis lance son analyse.

Code Description
204 No Content Installation et analyse valides
400 Bad Request Installation invalide ou erreur retournée par LAD
403 Forbidden Privilège insuffisant

Cette opération ne reçoit aucun body.

Lire l'état d'indexation des contacts

GET /rest/mercure/lad/contactIndexations

La réponse 200 OK contient :

{
  "dateIndexation": "2026-08-21 10:00:00",
  "countIndexedContacts": 450,
  "countAllContacts": 500,
  "pctIndexationContacts": 90
}
Propriété Type Description
dateIndexation string Contenu du marqueur de dernière indexation, ou chaîne vide
countIndexedContacts integer Contacts indexés
countAllContacts integer Total des contacts
pctIndexationContacts number Pourcentage calculé

Lorsque config/ladConfiguration.json est absent, le contrôleur retourne un objet contenant errors avec un statut HTTP 200. Ce comportement historique doit être pris en compte par le client.

Lire l'état de l'abonnement Mercure WebService

GET /rest/mercure/webservice/subscriptionState

Le contrôleur relaie la réponse de api/subscribe/status avec le jeton Mercure stocké côté serveur.

Code Description
200 OK Objet d'état retourné par Mercure
204 No Content Aucun abonnement pour l'utilisateur
403 Forbidden Privilège insuffisant

Routes privées non publiées

Route Classement Justification
POST /rest/mercure/lad Privée frontend Analyse le fichier d'indexation ; aucun privilège dédié
GET /rest/mercure/lad/isEnabled Privée frontend Détection de fonctionnalité
GET /rest/mercure/webservice/account Administration sensible Retourne un jeton Mercure au client
GET /rest/mercure/webservice/documents/{token} Administration sensible Jeton distant placé dans le chemin

La publication des deux routes transportant un jeton nécessite une décision sécurité. Les jetons et fichiers encodés ne doivent pas apparaître dans les exemples ou les journaux.