# Integrationsdesign — Integrationszyklus

Canonical page: https://apiopscycles.com/de/cycles/integration-productization-cycle/stations/api-design

Language: de

Entity ID: api-design

Cycle: [Integrationszyklus](https://apiopscycles.com/de/cycles/integration-productization-cycle.md)

Read [shared station guidance](https://apiopscycles.com/de/stations/api-design.md) first. The sections below supplement or replace the corresponding shared sections for this cycle. Sections not repeated here retain the shared guidance.

## Journey entry criteria

- Die Capability erfüllt einen klaren Geschäftsbedarf und kann von den vorgesehenen Nutzern wiederverwendet werden. — The API meets a clear business need and is reusable for multiple API consumers. (ID: api-reusability)
- Die gewählte Schnittstelle bietet Nutzern eine angemessene Abstraktion. — The API is intended to shield consumers from backend complexity and inconsistencies. (ID: hide-backend-discrepancies)
- Das Wertversprechen der Capability wurde mit Geschäfts- und Nutzer-Stakeholdern validiert. — The API value proposition has been reviewed and validated with the relevant business and consumer stakeholders. (ID: value-prop-validated)
- Die Nutzersegmente sind identifiziert. — API consumer segments (internal and external) are identified. (ID: consumer-segments-identified)
- Eine übergeordnete Roadmap für die Umsetzung ist definiert. — High-level roadmaps for API development are established. (ID: api-roadmap-defined)

## Journey exit criteria

- Die gewählte Architektur, Plattform und der Implementierungsstil wurden mit den relevanten Architektur-, Sicherheits- und Plattform-Stakeholdern validiert. — The chosen API architecture and platform patterns have been validated with the relevant architecture, security, and platform stakeholders. (ID: architecture-patterns-validated)
- Die gewählte Schnittstelle bietet Nutzern eine angemessene Abstraktion. — The API is intended to shield consumers from backend complexity and inconsistencies. (ID: hide-backend-discrepancies)
- Das Schnittstellendesign und die offengelegten Capabilities lassen sich klar auf Geschäftswert und Nutzerbedürfnisse zurückführen. — The API design and exposed capabilities clearly trace back to business value and user needs. (ID: design-reflects-business-value)
- Das Schnittstellendesign folgt den vereinbarten Designstandards und Konventionen. — The API design follows our shared API product and design conventions. (ID: api-consistency)

## Description

Entwerfen Sie Integrationslösung, Verträge, Schemas, Datenstrukturen, Mappings sowie Interaktions- oder Liefermuster für den ausgewählten Stil.

## Role participation and responsibilities

- [Integrationsarchitekt](https://apiopscycles.com/de/roles/integration-architect.md) (lead): Entwirft Integrationsansätze und Implementierungsstile, die die Capability oder API mit anderen Systemen verbinden.; suggested-answer-owner: [Canvas für Integrationslösungsdesign](https://apiopscycles.com/de/resources/integration-solution-design-canvas.md)
- [API-Designer](https://apiopscycles.com/de/roles/api-designer.md) (core): Gestaltet Schnittstellenvertrag, Interaktionsmodell, Konsistenz, Benutzerfreundlichkeit und bereitgestellte Capabilities.
- [Domain-Experte](https://apiopscycles.com/de/roles/domain-specialist.md) (core): Bringt tiefes Wissen über Geschäftsdomäne, Konzepte, Regeln und Einschränkungen ein, die die Capability oder Schnittstelle widerspiegeln muss.
- [Plattform-Architekt](https://apiopscycles.com/de/roles/platform-architect.md) (core): Leitet Entscheidungen zu Plattform, Integration, Skalierbarkeit und Architektur, die beeinflussen, wie die Capability oder API erstellt und betrieben wird.
- [Vertreter der API-Nutzer](https://apiopscycles.com/de/roles/api-consumer-specialist.md) (core): Vertritt die Anforderungen von Entwicklern, Integratoren und anderen Nutzern der API.
- [API-Entwickler](https://apiopscycles.com/de/roles/api-engineer.md) (consulted): Verantwortet Implementierung, Automatisierung, Tests und Release-Abläufe, die für die zuverlässige Bereitstellung der Capability, API oder Automatisierung erforderlich sind.
- [Compliance- und Rechtsexperte](https://apiopscycles.com/de/roles/compliance-specialist.md) (consulted): Klärt rechtliche, Datenschutz-, regulatorische und vertragliche Anforderungen, die Capability, API, Schnittstelle oder Automatisierung betreffen.
- [Sicherheitsspezialist](https://apiopscycles.com/de/roles/security-specialist.md) (consulted): Stellt sicher, dass Sicherheitsrisiken, Kontrollen und Vertrauensgrenzen über den gesamten Lebenszyklus hinweg berücksichtigt werden.

## Resources

- [Interaktions-Canvas](https://apiopscycles.com/de/resources/interaction-canvas.md)
- [Domänen-Canvas](https://apiopscycles.com/de/resources/domain-canvas.md)
- [Canvas für Integrationslösungsdesign](https://apiopscycles.com/de/resources/integration-solution-design-canvas.md)
