# API-julkaisu — API-tuotteistamisen sykli

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

Language: fi

Entity ID: api-publishing

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

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

- 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)
- 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)
- Rajapinta ja sen kyvykkyydet on dokumentoitu riittävän selkeästi katselmointia, auditointia ja käyttöönottoa varten. — The API and its exposed capabilities are described clearly enough for review, audit, and onboarding. (ID: api-description-available)
- Rajapintasuunnittelu noudattaa sovittuja suunnittelustandardeja ja käytäntöjä. — The API design follows our shared API product and design conventions. (ID: api-consistency)
- Rajapintasopimus on validoitu ja testattu toiminnallisia ja ei-toiminnallisia vaatimuksia vasten. — The API contract is tested and meets functional and non-functional requirements. (ID: api-contract-tested)

## Journey exit criteria

- Ratkaisu läpäisee laatu-, tietoturva-, vaatimustenmukaisuus- ja valmiustarkastukset. — The API passes compliance, security, and audit checks. (ID: audit-passed)
- Auditointihavainnot ja korjauspäätökset on jaettu olennaisille sidosryhmille. — Audit findings and remediation decisions are shared with the relevant stakeholders. (ID: audit-reports-shared)
- Kyvykkyys on valmis julkaistavaksi tai toimitettavaksi valitun toimitusmekanismin kautta. — The API is ready to be deployed and exposed through the intended gateways and environments. (ID: api-ready-for-publishing)
- Hyödyntäjille suunnattu dokumentaatio ja käyttöönottomateriaalit ovat valmiit. — Consumer-facing API documentation is complete enough for publishing and onboarding. (ID: api-documentation-ready)

## Description

Esittele APIt turvallisesti ja selkeästi oikealle yleisölle oikean dokumentaation ja prosessien avulla.

## Why it matters

Julkaiseminen on muutakin kuin käyttöönottoa - kyse on löydettävyydestä, saatavuudesta ja tuesta. Jos rajapintoja ei julkaista oikein, niitä ei käytetä, käytetä uudelleen tai suojata tehokkaasti.

## Apply in work

Mahdollistetaan APIen julkaiseminen asiaankuuluvassa ympäristössä ja selkeät rekisteröinti- ja käyttöoikeusmekanismit (esim. API-avaimet, OAuth, tilaussuunnitelmat) API-hyödyntäjäsegmenttien sekä turvallisuus- ja vaatimustenmukaisuusvaatimusten mukaan.

## Outcomes

- APIt julkaistaan oikeassa ympäristössä (yksityinen, kumppani, julkinen).
- Selkeät API-käyttöönotto- ja rekisteröintiprosessit
- Dokumentaatio, turvallisuusmallit ja -käytännöt saatavilla
- APIt valmiina skaalautumiseen ja hallintaan

## Steps

1. Julkaise rajapinnat asianmukaisiin yhdyskäytäviin ja ympäristöihin, jotta ne ovat uudelleenkäytettävissä useille API-hyödyntäjille.
2. Dokumentoi, miten hyödyntäjät löytävät ja käyttävät rajapintaa, mukaan lukien sisäänkirjautumisprosessit ja rekisteröinti.
3. Varmista, että turvamallit, yhdyskäytävän kokoonpano ja oikeudelliset ehdot ovat selkeitä ja hyödyntäjien saatavilla.
4. Palaute ja kontrolli: Miten omaksumista, luottamusta, todellista käyttöä, ongelmia ja odottamatonta käyttäytymistä seurataan, ja mitkä ehdot käynnistävät pysäytyksen, palautuksen tai paluun manuaalityöhön?

## Questions

- Julkaise rajapinnat asianmukaisiin yhdyskäytäviin ja ympäristöihin, jotta ne ovat uudelleenkäytettävissä useille API-hyödyntäjille.
- Dokumentoi, miten hyödyntäjät löytävät ja käyttävät rajapintaa, mukaan lukien sisäänkirjautumisprosessit ja rekisteröinti.
- Varmista, että turvamallit, yhdyskäytävän kokoonpano ja oikeudelliset ehdot ovat selkeitä ja hyödyntäjien saatavilla.
- Mahdollistetaan APIen julkaiseminen asiaankuuluvassa ympäristössä ja selkeät rekisteröinti- ja käyttöoikeusmekanismit (esim. API-avaimet, OAuth, tilaussuunnitelmat) API-hyödyntäjäsegmenttien sekä turvallisuus- ja vaatimustenmukaisuusvaatimusten mukaan.
- Julkaiseminen on muutakin kuin käyttöönottoa - kyse on löydettävyydestä, saatavuudesta ja tuesta. Jos rajapintoja ei julkaista oikein, niitä ei käytetä, käytetä uudelleen tai suojata tehokkaasti.

## Role participation and responsibilities

- [API-tuoteomistaja](https://apiopscycles.com/fi/roles/api-product-owner.md) (lead): Ohjaa API-mahdollisuutta, priorisointia ja tuotetasolla tehtyjä päätöksiä elinkaaren aikana.
- [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.
- [Dokumentoinnin ja kehittäjäsuhteiden omistaja](https://apiopscycles.com/fi/roles/api-devrel-specialist.md) (core): Varmistaa, että API-dokumentaatio, esimerkit, koulutus ja kehittäjäsuhteiden strategiat tukevat API-hyödyntäjien tarpeita.
- [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.
- [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

- [API-auditoinnin tarkistuslista](https://apiopscycles.com/fi/resources/api-audit-checklist.md)