Station

Conception de solution d’intégration

Concevoir le contrat d interface, les schemas, les payloads et les modeles d interaction pour le style d integration choisi.

Une bonne conception va au-delà du nommage des endpoints. Elle garantit que l'interface est utilisable, cohérente, vérifiable et traçable aux besoins métier et utilisateurs.

Votre parcours sur la carte

Plan de métro

Select a cycle, station, or stakeholder to open its permanent method page.

StratégiqueGouvernanceConsommateurTechniqueExpérience utilisateurExpérience utilisateurAperçus du marchéAperçus du marchéObjectifs de l'entrepriseObjectifs de l'entrepriseAnalyse concurrentielleAnalyse concurrentielleVision de l'écosystèmeVision de l'écosystèmeInfrastructure évolutiveInfrastructure évolutiveJuridique et conformitéJuridique et conformitéSécurité et confidentialitéSécurité et confidentialitéNormes de conceptionNormes de conceptionGestion des fournisseursGestion des fournisseursConception des contratsConception des contratsDéveloppementDéveloppementCI/CDCI/CDAutomatisation des testsAutomatisation des testsGestion des versionsGestion des versionsAccords de serviceAccords de serviceAdoption de l'API par les utilisateursAdoption de l'API par les utilisateursPromotion de l'APIPromotion de l'APIIntégration des partenairesIntégration des partenairesL'état d'esprit de l'APIL'état d'esprit de l'APIRôles et responsabilitésRôles et responsabilitésUpkillingUpkillingLignes directrices opérationnellesLignes directrices opérationnellesGestion de portefeuilleGestion de portefeuilleGestion du budget et des ressourcesGestion du budget et des ressourcesStratégie de capacité1Stratégie de capacitéd’intégrationExigences utilisateurs & onboarding2Exigences desutilisateursd’intégration &Architecture & décisions de plateforme3Architecture dintegration & decisionsde plateformeConception de solution & d'interface4Conception de solutiond’intégrationMise à disposition & opérations5Livraison & opérationsd’intégrationAssurance qualité & préparation6Assurance qualité desintégrationsPublication & enablement7Publication & enablementde l integrationSuivi & amélioration8Suivi & amélioration desintégrationsLigne des opportunités métierLigne d'architecture de la plateformeLigne de conception de l'APILigne de livraisonLigne Publication & EnablementLigne de modèle opérationnel

Selected station: Conception de solution & d'interface

Personnes à impliquer

Ressources associées

Résultats

  • Un contrat d'interface validé pour le mode de mise en œuvre choisi
  • Contrats d'interface réutilisables et validés
  • Conceptions alignées sur les modèles de domaine et les modèles d'interaction
  • Traçabilité de la conception à la valeur métier

Critères du parcours

Critères d'entrée

  • La capacité répond à un besoin métier clair et peut être réutilisée par les utilisateurs prévus.
  • L’interface choisie fournit une abstraction appropriée aux utilisateurs.
  • La proposition de valeur de la capacité a été validée avec les parties prenantes métier et utilisateurs.
  • Les segments d'utilisateurs sont identifiés.
  • Une feuille de route de haut niveau pour la mise en œuvre est définie.

Critères de sortie

  • L'architecture, la plateforme et le mode de mise en œuvre choisis ont été validés avec les parties prenantes concernées en architecture, sécurité et plateforme.
  • L’interface choisie fournit une abstraction appropriée aux utilisateurs.
  • La conception de l'interface et les capacités exposées sont clairement reliées à la valeur métier et aux besoins des utilisateurs.
  • La conception de l'interface respecte les standards partagés de produit, de conception et de qualité.

Voici à quoi ressemble le succès

Utilisez les ressources de conception adaptées au mode de mise en œuvre choisi, par exemple REST, GraphQL, événements, fichiers, produits de données ou intégration directe.

  1. Clarifiez les objets métier, les termes, les règles et les responsabilités avant de concevoir le contrat d'interface. — Domain Canvas
  2. Utilisez le canevas d'interaction pour définir la manière dont les utilisateurs interagiront avec l'API, en veillant à ce qu'elle réponde à leurs besoins et à leurs attentes. — Interaction Canvas
  3. Appliquer les modèles de conception REST pour créer des contrats d'interface cohérents et réutilisables qui sont validés avec les parties prenantes. — REST Canvas
  4. Appliquer des modèles de conception orientés événements pour créer des contrats d'interface cohérents et réutilisables qui sont validés avec les parties prenantes. — Event Canvas
  5. Appliquer les modèles de conception GraphQL pour créer des contrats d'interface cohérents et réutilisables qui sont validés avec les parties prenantes.
  6. Utiliser les principes de conception et le guide de style des API pour aligner vos décisions de conception sur des règles communes et permettre une validation d'audit cohérente. — Principes de conception de l'API
  7. Appliquez des approches « contract-first » ou « design-first » pour définir et valider le contrat de l'API avant sa mise en œuvre.
  8. Utilisez la liste de contrôle d'audit des API pour vous assurer que la conception de l'API répond aux exigences fonctionnelles et non fonctionnelles, notamment en matière de sécurité, de performances et de conformité. — Liste de contrôle de l'audit de l'API

Metro lines

Ligne de conception de l'API

Se concentre sur les principes et les bonnes pratiques de conception des interfaces et des solutions d'intégration.

Ressources associées

Browse the resources selected for Conception de solution d’intégration; the summary above explains how they support this station’s work.

Ressources

Resources for Conception de solution d’intégration

canvas

Interaction Canvas

Définir les interactions API, les flux de travail et les réponses attendues afin de garantir une expérience cohérente pour les consommateurs d'API.

Résultats

  • Modèle d’interaction défini pour la capacité choisie
  • Entrées, sorties, commandes, requêtes, événements et réponses clarifiés
  • Règles de validation et attentes d’interaction convenues

Comment cela fonctionne-t-il ?

  1. Associer les interactions de l'API aux tâches de l'utilisateur
  2. Définir des points finaux pour chaque interaction
  3. Documentez les entrées et les sorties de chaque interaction.
  4. Spécifier les règles et contraintes de validation
  5. Créer des modèles d'interaction pour les interactions CRUD, axées sur les requêtes, axées sur les commandes et axées sur les événements.

Relevant cycles

Cycle d’automatisation

Cycle pour identifier, concevoir, livrer, enable et améliorer des opportunités d’automatisation.