Service HTTP

Statut documentaire : architecture — voir Maturité et preuves.

Rôle

La famille de services HTTP fournit une frontière HTTP autour des capacités publiées de logiCells et des ressources web. Elle peut servir aux endpoints applicatifs, à la publication web, aux adaptateurs d'API et à l'intégration de services Runtime.

Le contrat public est la capacité publiée, et non une classe serveur privée ou une balise de configuration historique.

Architecture

capacité du modèle
    -> contrat de publication
    -> adaptateur HTTP
    -> endpoint HTTP
    -> client

Utiliser HTTP lorsque

• un client a besoin d'un accès requête/réponse à une capacité publiée ;
• une application expose des endpoints de type REST ou des services HTTP documentés ;
• du contenu web ou un renderer est hébergé derrière une frontière HTTP ;
• un adaptateur RPC utilise HTTP comme transport.

Règles opérationnelles

• configurer TLS pour les endpoints distants en production ;
• rendre l'authentification et l'autorisation explicites à la frontière applicative ;
• appliquer des timeouts aux appels distants ;
• ne réessayer que les opérations sûres ou idempotentes ;
• propager les identifiants de corrélation ;
• ne pas exposer les objets Runtime privés comme identifiants métier durables.

Exécution locale et distante

HTTP est une frontière de transport. Il ne redéfinit pas le modèle applicatif. Un SDK généré peut cibler un Runtime local ou distant tout en préservant le même modèle objet public lorsque la capacité offre cette parité.

Statut de configuration

Les noms exacts de modules serveur, balises de configuration et anciens exemples .services dépendent des versions et relèvent de l'implémentation. Ils ne sont donc pas présentés ici comme des contrats publics stables. Utiliser la référence de configuration correspondant à la version du Runtime déployée.