Un cadre commun, des usages locaux
L’API dépend des identités, modèles de données et services sous-jacents.
Définir un noyau de règles communes, les données à consolider et les variantes autorisées. Chaque entité doit savoir ce qu’elle peut décider localement et ce qui nécessite une coordination, et les exceptions doivent rester visibles au niveau pertinent.
Décrire opérations, données, authentification, autorisation, erreurs, quotas, versions et engagements.
Le propriétaire de l’API porte le contrat, les consommateurs déclarent leurs usages, et sécurité et exploitation vérifient les contraintes.
Application à votre contexte
Distinguez le socle obligatoire et les variantes locales justifiées. Utilisez des identifiants communs et un circuit de remontée des changements, mais n'écrasez pas une contrainte locale pertinente pour obtenir artificiellement un modèle uniforme.
Comparez la complexité totale, et non seulement la sophistication technique. Une solution distribuée apporte des possibilités mais aussi des pannes partielles et des exigences d'exploitation. Choisissez une architecture que les équipes peuvent livrer, comprendre et faire évoluer.
Dans une organisation multisite
Standardiser les contrats d’interface et les contrôles de livraison sans imposer une architecture identique à tous les produits.