# Hyödyntäjien vaatimukset ja käyttöönotto

Canonical page: https://apiopscycles.com/fi/stations/api-consumer-experience

Language: fi

Entity ID: api-consumer-experience

## Description

Kokoa hyödyntäjien käyttöönotto, standardit, ei-toiminnalliset vaatimukset, palveluodotukset, rajoitteet, tietoturvatarpeet, sallitut protokollat, datan tuoreus, palvelutasot, havainnoitavuus, palautuminen, käyttöönoton vaatimukset ja tuottajan vastuut.

## Why it matters

Oikea arkkitehtuuri riippuu hyödyntäjien tavoitteista, käyttöönotto-odotuksista, palvelutasoista, datan laatutarpeista, muutosten sietokyvystä, havainnoitavuudesta, tuesta ja tuottajan rajoitteista.

## Apply in work

Käytä hyödyntäjäkokemuksen ja käyttöönoton ohjeistusta, jotta odotukset ovat selkeitä sekä hyödyntäjille että tuottajille.

## Outcomes

- Dokumentoidut hyödyntäjävaatimukset ja käyttöönotto-odotukset
- Selkeät tuottajan vastuut ja tukiin liittyvät odotukset
- Arkkitehtuurin kannalta olennaiset rajoitteet valmiina päätöksentekoon
- Parempi käyttöönotto hyödyntäjäymmärryksen, standardien ja tuottajan selkeyden kautta

## Steps

1. Käytä kokemusvaatimusten kanvasta hyödyntäjien tavoitteiden, saatavuuden, tuoreuden, volyymin, suorituskyvyn, datan laadun, tietoturvan, käyttöönoton, muutoksen, havainnoitavuuden ja palautumisen odotusten kuvaamiseen.
2. Kuvaa käyttöönotto-ohjeistuksen avulla, miten hyödyntäjät löytävät kyvykkyyden, pyytävät sen käyttöä, testaavat sitä, saavat hyväksynnän ja aloittavat käytön.
3. Käytä syntyvää polkua ja vaatimuksia kyvykkyyden hyödyntäjien käyttöönoton, dokumentaation, tuen ja palautesilmukoiden parantamiseen.

## Questions

- Käytä kokemusvaatimusten kanvasta hyödyntäjien tavoitteiden, saatavuuden, tuoreuden, volyymin, suorituskyvyn, datan laadun, tietoturvan, käyttöönoton, muutoksen, havainnoitavuuden ja palautumisen odotusten kuvaamiseen.
- Kuvaa käyttöönotto-ohjeistuksen avulla, miten hyödyntäjät löytävät kyvykkyyden, pyytävät sen käyttöä, testaavat sitä, saavat hyväksynnän ja aloittavat käytön.
- Käytä syntyvää polkua ja vaatimuksia kyvykkyyden hyödyntäjien käyttöönoton, dokumentaation, tuen ja palautesilmukoiden parantamiseen.
- Käytä hyödyntäjäkokemuksen ja käyttöönoton ohjeistusta, jotta odotukset ovat selkeitä sekä hyödyntäjille että tuottajille.
- Oikea arkkitehtuuri riippuu hyödyntäjien tavoitteista, käyttöönotto-odotuksista, palvelutasoista, datan laatutarpeista, muutosten sietokyvystä, havainnoitavuudesta, tuesta ja tuottajan rajoitteista.

## Evidence

- design-artifact
- documentation
- consumer-feedback

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

## Role participation and responsibilities

- [API-hyödyntäjien edustaja](https://apiopscycles.com/fi/roles/api-consumer-specialist.md) (lead): Edustaa kehittäjien, integraattoreiden tai muiden API-hyödyntäjien tarpeita, jotka käyttävät APIa suoraan.; suggested-answer-owner: [Integraation hyödyntäjän ja tarjoajan sitoumuskanvas](https://apiopscycles.com/fi/resources/integration-consumer-provider-requirements-canvas.md)
- [API-tuoteomistaja](https://apiopscycles.com/fi/roles/api-product-owner.md) (lead): Ohjaa API-mahdollisuutta, priorisointia ja tuotetasolla tehtyjä päätöksiä elinkaaren aikana.
- [Asiakas- tai kumppaniedustaja](https://apiopscycles.com/fi/roles/customer-specialist.md) (lead): Edustaa asiakkaan tai kumppanin näkökulmaa polkuun, arvoon ja yhteistyömalliin.; suggested-answer-owner: [Kyvykkyyden hyödyntäjän ja tuottajan sitoumuskanvas](https://apiopscycles.com/fi/resources/capability-consumer-producer-requirements-canvas.md)
- [Prosessin omistaja](https://apiopscycles.com/fi/roles/process-owner.md) (lead): Vastaa automatisoitavasta liiketoimintaprosessista, mukaan lukien tavoitteet, säännöt, tulokset ja kehittämisen prioriteetit.
- [Automaation omistaja](https://apiopscycles.com/fi/roles/automation-owner.md) (core): Vastaa automaation tavoitteista, liiketoiminta-arvosta, priorisoinnista, kontrolleista ja elinkaaren tuloksista.
- [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.
- [Integraatioarkkitehti](https://apiopscycles.com/fi/roles/integration-architect.md) (core): Suunnittelee integraatiotavat ja toteutustavat, joilla kyvykkyys tai API yhdistetään muihin järjestelmiin.
- [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.
- [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.
- [API-suunnittelija](https://apiopscycles.com/fi/roles/api-designer.md) (consulted): Suunnittelee rajapintasopimuksen, vuorovaikutusmallin, johdonmukaisuuden, käytettävyyden ja tarjottavat kyvykkyydet.
- [Automaatiokehittäjä](https://apiopscycles.com/fi/roles/automation-engineer.md) (consulted): Toteuttaa, testaa, integroi ja ylläpitää automaatioratkaisuja ja niitä tukevia työnkulkuja.
- [Kumppani- ja toimittajavastaava](https://apiopscycles.com/fi/roles/partner-specialist.md) (consulted): Koordinoi ulkoisia kumppani-, toimittaja- ja alihankkijasuhteita, jotka vaikuttavat kyvykkyys- tai API-strategiaan ja toimitukseen.
- [Liiketoiminnan omistaja](https://apiopscycles.com/fi/roles/business-owner.md) (consulted): Edustaa liiketoimintatavoitteita, rahoitusta ja odotettuja tuloksia kyvykkyys-, API- tai automaatiohankkeessa.
- [Turvallisuusasiantuntija](https://apiopscycles.com/fi/roles/security-specialist.md) (consulted): Varmistaa, että turvallisuusriskit, kontrollit ja luottamusrajat käsitellään koko elinkaaren aikana.
- [Vaatimustenmukaisuus- ja lakiasiantuntija](https://apiopscycles.com/fi/roles/compliance-specialist.md) (consulted): Selventää juridiset, tietosuojaan liittyvät, sääntelyyn liittyvät ja sopimukselliset vaatimukset, jotka vaikuttavat kyvykkyyteen, APIin, rajapintaan tai automaatioon.

## Cycle-specific guidance

- [Kyvykkyyden tuotteistamisen sykli](https://apiopscycles.com/fi/cycles/capability-productization-cycle/stations/api-consumer-experience.md)
- [API-tuotteistamisen sykli](https://apiopscycles.com/fi/cycles/api-productization-cycle/stations/api-consumer-experience.md)
- [Integraatiokyvykkyyden tuotteistamisen sykli](https://apiopscycles.com/fi/cycles/integration-productization-cycle/stations/api-consumer-experience.md)
- [Automaatiosykli](https://apiopscycles.com/fi/cycles/automation-cycle/stations/api-consumer-experience.md)