# Kyvykkyysratkaisun ja vuorovaikutuksen suunnittelu — Kyvykkyyden tuotteistamisen sykli

Canonical page: https://apiopscycles.com/fi/cycles/capability-productization-cycle/stations/api-design

Language: fi

Entity ID: api-design

Cycle: [Kyvykkyyden tuotteistamisen sykli](https://apiopscycles.com/fi/cycles/capability-productization-cycle.md)

Read [shared station guidance](https://apiopscycles.com/fi/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

- Kyvykkyys vastaa selkeään liiketoimintatarpeeseen ja on uudelleenkäytettävissä tarkoitetuille hyödyntäjille. — The API meets a clear business need and is reusable for multiple API consumers. (ID: api-reusability)
- Valittu rajapinta tarjoaa hyödyntäjille sopivan abstraktion. — The API is intended to shield consumers from backend complexity and inconsistencies. (ID: hide-backend-discrepancies)
- Kyvykkyyden arvolupaus on validoitu liiketoiminnan ja hyödyntäjien sidosryhmien kanssa. — The API value proposition has been reviewed and validated with the relevant business and consumer stakeholders. (ID: value-prop-validated)
- Hyödyntäjäsegmentit on tunnistettu. — API consumer segments (internal and external) are identified. (ID: consumer-segments-identified)
- Ylätason toteutuksen etenemissuunnitelma on määritelty. — High-level roadmaps for API development are established. (ID: api-roadmap-defined)

## Journey exit criteria

- Valittu arkkitehtuuri, alusta ja toteutustapa on validoitu olennaisten arkkitehtuuri-, tietoturva- ja alustasidosryhmien kanssa. — The chosen API architecture and platform patterns have been validated with the relevant architecture, security, and platform stakeholders. (ID: architecture-patterns-validated)
- Valittu rajapinta tarjoaa hyödyntäjille sopivan abstraktion. — The API is intended to shield consumers from backend complexity and inconsistencies. (ID: hide-backend-discrepancies)
- Rajapintasuunnittelu ja tarjottavat kyvykkyydet ovat jäljitettävissä liiketoiminta-arvoon ja hyödyntäjien tarpeisiin. — The API design and exposed capabilities clearly trace back to business value and user needs. (ID: design-reflects-business-value)
- Rajapintasuunnittelu noudattaa sovittuja suunnittelustandardeja ja käytäntöjä. — The API design follows our shared API product and design conventions. (ID: api-consistency)

## Description

Kyvykkyysratkaisun ja vuorovaikutuksen suunnittelu: Ohjaa uudelleenkäytettävän kyvykkyyden määrittelyä hypoteesista ja kuluttaja-/tuottajavaatimuksista arkkitehtuuriin, ratkaisusuunnitteluun, toimitukseen, valmiuteen, julkaisuun ja jatkuvaan parantamiseen.

## Role participation and responsibilities

- [API-suunnittelija](https://apiopscycles.com/fi/roles/api-designer.md) (lead): Suunnittelee rajapintasopimuksen, vuorovaikutusmallin, johdonmukaisuuden, käytettävyyden ja tarjottavat kyvykkyydet.; suggested-answer-owner: [Kyvykkyysratkaisun suunnittelukanvas](https://apiopscycles.com/fi/resources/capability-solution-design-canvas.md)
- [Alusta-arkkitehti](https://apiopscycles.com/fi/roles/platform-architect.md) (core): Ohjaa alustan, integraation, skaalautuvuuden ja arkkitehtuurin päätöksiä, jotka määrittelevät, miten kyvykkyys tai API rakennetaan ja operoidaan.
- [API-hyödyntäjien edustaja](https://apiopscycles.com/fi/roles/api-consumer-specialist.md) (core): Edustaa kehittäjien, integraattoreiden tai muiden API-hyödyntäjien tarpeita, jotka käyttävät APIa suoraan.
- [Kyvykkyyden omistaja](https://apiopscycles.com/fi/roles/capability-owner.md) (core): Vastaa kyvykkyyden visiosta, arvosta, priorisoinnista, elinkaaresta ja uudelleenkäytöstä eri hyödyntäjille.
- [Liiketoiminta-asiantuntija](https://apiopscycles.com/fi/roles/domain-specialist.md) (core): Tuo syvällistä tietoa liiketoiminta-alueesta, käsitteistä, säännöistä ja rajoituksista, joita kyvykkyyden tai rajapinnan täytyy heijastaa.
- [API-tuoteomistaja](https://apiopscycles.com/fi/roles/api-product-owner.md) (consulted): Ohjaa API-mahdollisuutta, priorisointia ja tuotetasolla tehtyjä päätöksiä elinkaaren aikana.
- [Integraatioarkkitehti](https://apiopscycles.com/fi/roles/integration-architect.md) (consulted): Suunnittelee integraatiotavat ja toteutustavat, joilla kyvykkyys tai API yhdistetään muihin järjestelmiin.
- [Turvallisuusasiantuntija](https://apiopscycles.com/fi/roles/security-specialist.md) (consulted): Varmistaa, että turvallisuusriskit, kontrollit ja luottamusrajat käsitellään koko elinkaaren aikana.

## Resources

- [Vuorovaikutuskanvas](https://apiopscycles.com/fi/resources/interaction-canvas.md)
- [Toimialuekanvas](https://apiopscycles.com/fi/resources/domain-canvas.md)
- [Kyvykkyysratkaisun suunnittelukanvas](https://apiopscycles.com/fi/resources/capability-solution-design-canvas.md)