Stakeholder guide

Integration Architect

Designs integration approaches and implementation styles that connect the capability or API with other systems.

Relevant cycles

Automation Cycle

A cycle for identifying, designing, delivering, enabling, and improving automation opportunities.

Relevant stations

  • Architecture & Platform Decisions

    Use requirements and constraints to decide the right architecture pattern and enabling platform capabilities.

  • Solution & Interface Design

    Design the interface contract and interaction model after the architecture choice is justified.

  • Strategy

    Frame the business need as a reusable capability before choosing the implementation style.

  • Consumer Requirements & Onboarding

    Capture consumer onboarding, standards, non-functional requirements, service expectations, constraints, security needs, allowed protocols, data freshness, SLAs, observability, recovery, adoption requirements, and producer responsibilities.

  • Delivery & Operations

    Deliver the selected implementation style with appropriate engineering, testing, security, automation, and operational practices.

  • Quality & Readiness Assurance

    Audit the capability interface contract, controls, support model, observability, documentation, and lifecycle readiness before release.

  • Publishing & Enablement

    Publish reusable capability information so consumers can discover, request, onboard, use, and get support.

  • Monitoring & Improvement

    Monitor usage, reliability, data quality, consumer outcomes, operational cost, and reuse opportunities after release.

Decisions and outputs

Decisions

  • Use the Business Impact Canvas to identify availability, security, and data risks that influence architecture options.
  • Use the Locations Canvas to capture geopolitical, regulatory, network, residency, and trust-boundary constraints.
  • Use the Capacity Canvas to capture current and future volumes, peaks, latency, caching, rate limiting, and scaling expectations.
  • Use metrics and analytics guidance to define how the chosen capability will be monitored and improved.
  • Compare viable architecture styles against the gathered requirements and document the selected pattern and rationale.
  • Architecture choices should follow from evidence about business impact, locations, trust boundaries, capacity, latency, data ownership, consistency, operability, security, privacy, governance, and cost.

Outputs

  • A justified architecture choice
  • Documented risks, locations, capacity, security, privacy, and operability constraints
  • Clear rationale for API, event, file, stream, data product, direct integration, or hybrid implementation style
  • architecture-decision
  • documentation
  • platform-config
  • metrics
  • A validated interface contract for the selected implementation style

Recommended resources

Facilitate as Integration Architect

Use these prepared prompts alongside the stakeholder decisions, outputs, stations, and resources summarized above.

AI facilitation

Prompt pack

Facilitate a station with Integration Architect

facilitate-station

Stakeholder: Integration Architect
Cycles: Capability Productization Cycle, Integration Productization Cycle, Automation Cycle
Stations: Architecture & Platform Decisions, Solution & Interface Design, Strategy, Consumer Requirements & Onboarding, Delivery & Operations, Quality & Readiness Assurance, Publishing & Enablement, Monitoring & Improvement
Resources and canvases: Business Impact Canvas, Locations Canvas, Capacity Canvas, Domain Canvas, Interaction Canvas, Customer Journey Canvas, Capability Value Proposition Canvas, Capability Business Model Canvas, Consumer Experience Requirements Canvas, REST Canvas, Event Canvas, GraphQL Canvas

Act as an APIOps Cycles facilitator. Use the selected station questions, entry criteria, exit criteria, stakeholders, and related resources to guide the discussion. Produce decisions, evidence gaps, and next steps.