Développeurs

API — Connect

Référence API — Connect

Connect est la couche de recherche transverse et d'export inter-modules : une seule barre de recherche qui interroge tous les modules, et un registre qui agrège leurs données indexables.

  • Base URL — prod : https://connect.puwapi.com · dev : http://localhost:6000
  • Auth : JWT.

Recherche & registre

Base : /api/connect

MéthodeRouteRôle
GET/api/connect/modulesRegistre des modules connectés
GET/api/connect/searchRecherche transverse (tous modules)
GET/api/connect/aggregateAgrégation inter-modules

La recherche s'appuie sur un moteur (Meilisearch). Chaque module opte pour l'indexation (toggle IsIndexed) ; seul le contenu opt-in remonte dans la recherche publique.

Contrat d'export des modules

Chaque module expose une route GET /connect/export ([AllowAnonymous], protégée) que Connect consomme pour indexer son contenu. Exemples : Knowledge et Hub exposent connect/export.

Surface interne (M2M)

Base : /api/connect/internalX-Internal-Secret.

MéthodeRouteRôle
PUT/api/connect/internal/modulesEnregistrer/mettre à jour un module
DELETE/api/connect/internal/modules/{moduleKey}Retirer un module
POST/api/connect/internal/reindexRéindexer
POST/api/connect/internal/searchRecherche interne
POST/api/connect/internal/documents/deleteRetirer des documents de l'index

Connect est le socle de la « recherche unique » du Hub : l'utilisateur cherche une fois, les résultats viennent des projets, documents, articles, clients, etc.

#api #connect