Intégration REST externe

Statut documentaire : reference — voir Maturité et preuves.

Cette page couvre l'utilisation d'HTTP comme frontière d'intégration. REST est un adaptateur autour des capacités logiCells ; il ne doit pas devenir le lieu où la logique métier est redéfinie.

Exposer logiCells

Pour exposer une capacité :

1. déclarer l'action dans le modèle ;
2. stabiliser sa signature ;
3. la marquer comme publiée ;
4. configurer l'adaptateur HTTP et ses routes ;
5. appliquer authentification, autorisation et validation ;
6. générer ou publier le contrat OpenAPI lorsque disponible.

Appeler une API externe

Lorsqu'une action logiCells dépend d'un service tiers :

• isoler le client HTTP derrière un adaptateur d'intégration ;
• ne pas mélanger DTO de transport et concepts métier ;
• définir timeout et politique de retry selon l'idempotence ;
• journaliser un identifiant de corrélation ;
• traduire les erreurs externes vers des erreurs du contrat applicatif ;
• ne jamais placer de secrets dans les identifiants d'objets ou les métadonnées publiques.

Synchronisme

Une requête courte peut rester synchrone. Une opération distante longue, instable ou multi-étapes doit généralement démarrer un processus/job et retourner un accusé de réception plutôt que bloquer la requête HTTP.

Portabilité

Le modèle métier doit rester utilisable même si l'intégration passe ultérieurement de REST à RPC, messaging ou un autre adaptateur.