Publication de services

Statut documentaire : reference — voir Maturité et preuves.

Un service publié est une projection contrôlée d'une capacité du modèle. Le contrat métier doit être défini avant le choix du transport.

Chaîne de publication

concept
  -> published action / collection
  -> service adapter
  -> route or protocol
  -> machine-readable contract

Principes

publier des capacités explicites plutôt que des détails d'implémentation ;
séparer contrat métier, transport et sécurité ;
rendre les erreurs et règles d'autorisation explicites ;
distinguer appels courts, opérations asynchrones et jobs durables ;
documenter les différences opérationnelles entre local et distant ;
versionner les changements incompatibles.

API et OpenAPI

Lorsque le transport est HTTP, un contrat OpenAPI peut documenter les routes, schémas et réponses exposés. OpenAPI décrit l'interface HTTP ; il ne remplace pas le modèle conceptuel ni le contrat Runtime.