# API-alustan arkkitehtuuri — API-tuotteistamisen sykli

Canonical page: https://apiopscycles.com/fi/cycles/api-productization-cycle/stations/api-platform-architecture

Language: fi

Entity ID: api-platform-architecture

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

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

- Kyvykkyysmahdollisuus on tunnistettu ja dokumentoitu. — Individual API opportunities are identified and documented. (ID: api-opportunity-documented)
- 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

- 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)

## Description

Varmistetaan skaalautuvuus, uudelleenkäyttö ja hallinta API- ja alustakomponenttien välillä.

## Why it matters

Kun rajapinnat skaalautuvat eri tiimeille, alustan on mahdollistettava hallinta ja uudelleenkäyttö nopeutta estämättä. Tällä asemalla kerrotaan, miten API-arkkitehtuurit voidaan suunnitella pitkäikäisiksi, turvallisiksi ja tehokkaiksi.

## Apply in work

Perustetaan skaalautuva, turvallinen ja vaatimustenmukainen infrastruktuuri API-toimintoja varten. Annetaan ohjeita arkkitehtuurin parhaista käytännöistä.

## Outcomes

- Vähennä turhia API-rajapintoja ja vähennä pilvialustakustannuksia.
- Johdonmukaisen hallinnon toteuttaminen ilman raskasta ylhäältä alaspäin suuntautuvaa valvontaa
- Suunnittelu sisäistä uudelleenkäyttöä ja ulkoista skaalautuvuutta varten

## Steps

1. Business Impact Canvas auttaa tunnistamaan ja lieventämään APIn saatavuuteen, tietoturvaan ja toiminnallisuuteen liittyviä riskejä ja tukemaan tietoon perustuvia arkkitehtuuripäätöksiä.
2. Kartoita API-palveluntarjoajien ja hyödyntäjien sääntely-, vaatimustenmukaisuus- ja verkkoasiointipaikat käytettävyyden ja vaatimustenmukaisuuden varmistamiseksi.
3. Capacity Canvas -ohjelmassa sovitetaan yhteen liiketoimintatapahtumien mallit, tulevat kulutustrendit ja tekniset ratkaisut, jotta voidaan varmistaa APIn skaalautuvuus ja suorituskyky. Se tarjoaa kriittisen panoksen skaalautumispäätöksiä ja infrastruktuurin suunnittelua varten.
4. Määrittele ja seuraa suorituskykymittareita (esim. API-kutsut, viiveet, virhetasot) ja hyväksyntämittareita (esim. NPS).

## Questions

- Business Impact Canvas auttaa tunnistamaan ja lieventämään APIn saatavuuteen, tietoturvaan ja toiminnallisuuteen liittyviä riskejä ja tukemaan tietoon perustuvia arkkitehtuuripäätöksiä.
- Kartoita API-palveluntarjoajien ja hyödyntäjien sääntely-, vaatimustenmukaisuus- ja verkkoasiointipaikat käytettävyyden ja vaatimustenmukaisuuden varmistamiseksi.
- Capacity Canvas -ohjelmassa sovitetaan yhteen liiketoimintatapahtumien mallit, tulevat kulutustrendit ja tekniset ratkaisut, jotta voidaan varmistaa APIn skaalautuvuus ja suorituskyky. Se tarjoaa kriittisen panoksen skaalautumispäätöksiä ja infrastruktuurin suunnittelua varten.
- Määrittele ja seuraa suorituskykymittareita (esim. API-kutsut, viiveet, virhetasot) ja hyväksyntämittareita (esim. NPS).
- Perustetaan skaalautuva, turvallinen ja vaatimustenmukainen infrastruktuuri API-toimintoja varten. Annetaan ohjeita arkkitehtuurin parhaista käytännöistä.
- Kun rajapinnat skaalautuvat eri tiimeille, alustan on mahdollistettava hallinta ja uudelleenkäyttö nopeutta estämättä. Tällä asemalla kerrotaan, miten API-arkkitehtuurit voidaan suunnitella pitkäikäisiksi, turvallisiksi ja tehokkaiksi.

## Role participation and responsibilities

- [Alusta-arkkitehti](https://apiopscycles.com/fi/roles/platform-architect.md) (lead): Ohjaa alustan, integraation, skaalautuvuuden ja arkkitehtuurin päätöksiä, jotka määrittelevät, miten kyvykkyys tai API rakennetaan ja operoidaan.
- [API-arkkitehti](https://apiopscycles.com/fi/roles/api-architect.md) (core): Vastaa API-arkkitehtuurista, suunnitteluperiaatteista ja rajapintasopimusten laadusta.; suggested-answer-owner: [Sijaintikanvas](https://apiopscycles.com/fi/resources/location-canvas.md); suggested-answer-owner: [Kapasiteettikanvas](https://apiopscycles.com/fi/resources/capacity-canvas.md)
- [API-tuoteomistaja](https://apiopscycles.com/fi/roles/api-product-owner.md) (core): Ohjaa API-mahdollisuutta, priorisointia ja tuotetasolla tehtyjä päätöksiä elinkaaren aikana.; suggested-answer-owner: [Liiketoimintavaikutuskanvas](https://apiopscycles.com/fi/resources/business-impact-canvas.md)
- [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.
- [Tuki- ja operaatioiden omistaja](https://apiopscycles.com/fi/roles/operations-specialist.md) (core): Edustaa tuotannon tukea, häiriönhallintaa, havainnoitavuutta ja operatiivista valmiutta kyvykkyydelle, APIlle tai automaatiolle.
- [Turvallisuusasiantuntija](https://apiopscycles.com/fi/roles/security-specialist.md) (core): Varmistaa, että turvallisuusriskit, kontrollit ja luottamusrajat käsitellään koko elinkaaren aikana.
- [Vaatimustenmukaisuus- ja lakiasiantuntija](https://apiopscycles.com/fi/roles/compliance-specialist.md) (core): Selventää juridiset, tietosuojaan liittyvät, sääntelyyn liittyvät ja sopimukselliset vaatimukset, jotka vaikuttavat kyvykkyyteen, APIin, rajapintaan tai automaatioon.
- [API-hyödyntäjien edustaja](https://apiopscycles.com/fi/roles/api-consumer-specialist.md) (consulted): Edustaa kehittäjien, integraattoreiden tai muiden API-hyödyntäjien tarpeita, jotka käyttävät APIa suoraan.
- [Liiketoiminnan omistaja](https://apiopscycles.com/fi/roles/business-owner.md) (consulted): Edustaa liiketoimintatavoitteita, rahoitusta ja odotettuja tuloksia kyvykkyys-, API- tai automaatiohankkeessa.
- [Toimituskehittäjä](https://apiopscycles.com/fi/roles/api-engineer.md) (consulted): Vastaa toteutuksesta, automaatiosta, testauksesta ja julkaisun kulusta, joita kyvykkyyden, APIn tai automaation luotettava toimittaminen edellyttää.

## Resources

- [Liiketoimintavaikutuskanvas](https://apiopscycles.com/fi/resources/business-impact-canvas.md)
- [Sijaintikanvas](https://apiopscycles.com/fi/resources/location-canvas.md)
- [Kapasiteettikanvas](https://apiopscycles.com/fi/resources/capacity-canvas.md)