Comment constituer un catalogue d’interfaces entre systèmes ?

Question

IT Interview Practice · Accepted Answer

Construisez un **catalogue d’interfaces** comme un inventaire entretenu des contrats entre systèmes et de leurs responsables. Il relie le diagramme d’architecture aux détails nécessaires à l’implémentation, au traitement des incidents et à la planification des changements.

## Partir des flux métier

Parcourez un processus réel, par exemple l’exécution d’une commande, et recensez chaque appel API, événement, transfert de fichier et échange de données planifié. Incluez les chemins moins visibles, tels que les exports de rapprochement et les imports manuels de reprise.

Pour chaque interface, consignez :

- Un identifiant stable, l’objectif métier, le producteur, les consommateurs et les contacts responsables.
- Le sens, le transport, l’endpoint ou l’emplacement du fichier, et un lien vers le schéma versionné.
- La responsabilité des données, les identifiants, la classification et le mécanisme d’accès, sans stocker de secrets d’authentification.
- Les délais ou horaires, le volume attendu, les limites de taille et les engagements de service convenus.
- Les règles de timeout, de nouvelle tentative, de doublons, d’ordre et de gestion des erreurs lorsqu’elles s’appliquent.
- La supervision, l’escalade, la politique de compatibilité et les dépendances pour le retrait.

## Exemple d’entrée

L’interface IF-07 envoie les confirmations d’expédition d’un entrepôt vers une plateforme de commandes toutes les 15 minutes. L’entrepôt est responsable du flux ; la plateforme de commandes est responsable de l’ingestion. Le contrat définit un identifiant d’expédition, une version de schéma, un nombre d’enregistrements et un fichier d’accusé de réception. Les accusés manquants sont signalés à une équipe de support nommée.

C’est plus utile qu’une flèche « intégration » : une équipe peut déterminer si une mise à jour d’expédition tardive vient d’un problème de transport, de données rejetées ou d’une exécution manquée.

## Maintenir la fiabilité du catalogue

Pointez vers les schémas et procédures d’exploitation plutôt que de recopier leur contenu. Actualisez le catalogue lorsqu’une interface change et comparez-le périodiquement au trafic observé et aux tâches planifiées. Un inventaire statique manque rapidement les connexions officieuses.

## Piège en entretien

Une liste d’endpoints seule ne décrit pas un contrat. Une réponse solide inclut le sens métier, les responsabilités et le comportement en cas d’erreur, avec un niveau de détail qui reste maintenable.

Partir des flux métier

Exemple d’entrée

Maintenir la fiabilité du catalogue

Piège en entretien

Questions connexes