# API-suunnittelija

Canonical page: https://apiopscycles.com/fi/roles/api-designer

Language: fi

Entity ID: api-designer

Suunnittelee rajapintasopimuksen, vuorovaikutusmallin, johdonmukaisuuden, käytettävyyden ja tarjottavat kyvykkyydet.

## Decisions

- Käytä Domain Canvas -pohjaa uudelleen liiketoimintaolioiden, termien, sääntöjen ja omistajuuden vahvistamiseen ennen sopimussuunnittelua.
- Kuvaa Interaction Canvas -pohjan avulla, miten hyödyntäjät, järjestelmät tai käyttäjät ovat vuorovaikutuksessa kyvykkyyden kanssa.
- Käytä REST-suunnitteluresursseja, kun valittu rajapinta on REST API.
- Käytä Event Canvas -resursseja, kun valittu rajapinta on tapahtumapohjainen.
- Käytä GraphQL-suunnitteluresursseja, kun valittu rajapinta on GraphQL.
- Käytä suunnitteluperiaatteita ja tyyliopasta, jotta suunnittelupäätökset ovat linjassa yhteisten sääntöjen kanssa ja auditointi voi validoida ne johdonmukaisesti.

## Outputs

- Validoitu rajapintasopimus valitulle toteutustavalle
- Johdonmukaiset vuorovaikutus-, data-, tapahtuma-, tiedosto-, työnkulku- tai API-rajapintasopimuspäätökset
- Suunnittelun jäljitettävyys kyvykkyyden ja hyödyntäjien vaatimuksiin
- Suunnitelmat linjassa toimialamallien ja vuorovaikutusmallien kanssa
- spec
- contract
- design-artifact
- documentation

## Recommended resources

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

## Participation by cycle and station

- [Kyvykkyyden tuotteistamisen sykli](https://apiopscycles.com/fi/cycles/capability-productization-cycle.md) / [Kyvykkyysratkaisun ja vuorovaikutuksen suunnittelu](https://apiopscycles.com/fi/cycles/capability-productization-cycle/stations/api-design.md): lead
- [Kyvykkyyden tuotteistamisen sykli](https://apiopscycles.com/fi/cycles/capability-productization-cycle.md) / [Kyvykkyyden toimitus ja operointi](https://apiopscycles.com/fi/cycles/capability-productization-cycle/stations/api-delivery.md): consulted
- [Kyvykkyyden tuotteistamisen sykli](https://apiopscycles.com/fi/cycles/capability-productization-cycle.md) / [Kyvykkyyden valmiuden varmistus](https://apiopscycles.com/fi/cycles/capability-productization-cycle/stations/api-audit.md): consulted
- [API-tuotteistamisen sykli](https://apiopscycles.com/fi/cycles/api-productization-cycle.md) / [API-hyödyntäjäkokemus](https://apiopscycles.com/fi/cycles/api-productization-cycle/stations/api-consumer-experience.md): consulted
- [API-tuotteistamisen sykli](https://apiopscycles.com/fi/cycles/api-productization-cycle.md) / [API-suunnittelu](https://apiopscycles.com/fi/cycles/api-productization-cycle/stations/api-design.md): lead
- [API-tuotteistamisen sykli](https://apiopscycles.com/fi/cycles/api-productization-cycle.md) / [API-toteutus](https://apiopscycles.com/fi/cycles/api-productization-cycle/stations/api-delivery.md): core
- [API-tuotteistamisen sykli](https://apiopscycles.com/fi/cycles/api-productization-cycle.md) / [API-auditointi](https://apiopscycles.com/fi/cycles/api-productization-cycle/stations/api-audit.md): core
- [Integraatiokyvykkyyden tuotteistamisen sykli](https://apiopscycles.com/fi/cycles/integration-productization-cycle.md) / [Integraation ratkaisusuunnittelu](https://apiopscycles.com/fi/cycles/integration-productization-cycle/stations/api-design.md): core
- [Integraatiokyvykkyyden tuotteistamisen sykli](https://apiopscycles.com/fi/cycles/integration-productization-cycle.md) / [Integraation toimitus ja operointi](https://apiopscycles.com/fi/cycles/integration-productization-cycle/stations/api-delivery.md): consulted