|
|
API-katalogen |
Som API-konsument ønsker jeg at distribusjoner av samme (eller geografisk komplementære) datasett fra ulike tilbydere eller er samlet under et datasett |
|
|
API-katalogen |
Som API-konsument ønsker jeg å bli varslet om endringer i API slik at jeg kan tilpasse meg endringer |
|
|
API-katalogen |
Som API-forvalter ønsker jeg å kjenne til brukere av API slik at jeg kan formidle endringer i API-et |
|
|
API-katalogen |
Som API-konsument ønsker jeg kunnskapsbase (f.eks. FAQ funksjonalitet) slik at jeg som bruker kan få svar på kjente utfordringer og ikke behøver å bruke tid på henvendelser |
|
|
API-katalogen |
Som API-konsument ønsker jeg kontaktinformasjon til brukerstøtte for API slik at jeg kan få hjelp om jeg står fast |
|
|
API-katalogen |
Som bruker ønsker jeg å kunne authentisere meg på en enkel måte mot katalogen slik at jeg kan gi tilbakemeldninger og melde om bruk av et API |
|
|
API-katalogen |
Som API-konsument ønsker jeg å kunne gi komme i dialog med API-eier og andre API-konsumenter og gi tilbakemeldinger, tips, stille spørsmål, melde om feil, gi innspill til endringer slik at dette kan hver til hjelp for meg, andre og data-eier. |
|
|
API-katalogen |
Som API-eier ønsker jeg å publisere API-er som ikke kan knyttes til et datasett slik at også mine mine API-er som gjør beregninger e.l. kan publiseres |
|
|
API-katalogen |
Som dataeier ønsker jeg at relevante opplysninger fra API-beskrivelsen er tilgjengelig i datasettbeskrivelsen slik at jeg unngår dobbeltarbeid |
|
|
API-katalogen |
Som forretningsutvikler ønsker jeg å se filtrere på datasett som tilbyr API slik at jeg kan benytte det i mine tjenester |
|
|
API-katalogen |
Som dataeier ønsker jeg å knytte API til datasettet slik at jeg kan vise hvilke distribusjoner som finnes |
|
|
API-katalogen |
Som API-forvalter ønsker jeg at API-katalog kan plukke opp min swagger dokumentasjon slik at jeg kan benytte dette verktøyet |
|
|
API-katalogen |
EPOS 4: Som API-konsument ønsker jeg å finne detaljert beskrivelse av API-ene slik at jeg kan vurdere om jeg kan benytte API-et i mine tjenester |
|
|
API-katalogen |
Som API-konsument ønsker jeg å se request og respons på et API slik at jeg kan planlegge design |
|
|
API-katalogen |
Som API-konsument ønsker jeg at API-er av autoritativ art priorites slik at de er lette å finne |
|
|
API-katalogen |
Som API-konsument ønsker jeg å søke og filtrere langs ulike kategorier (f.eks. formater, tilgangsnivå) på API slik at jeg minimerer tiden jeg bruker på å finne rett API |
|
|
API-katalogen |
Som API-forvalter ønsker jeg en godt dokumentert felles løsning for registering av API-beskrivelser slik at jeg slipper å installere egne verktøy. |
|
|
API-katalogen |
Som API-forvalter ønsker jeg en å samle beskrivelser av API-ene våre og andres slik at det er enkelt å få oversikt over API-er og bruk |
|
|
API-katalogen |
Som API-konsument ønsker jeg at API-beskrivelser er oppdaterte, og at API-er som ikke lenger er tilgjengelig/deprecated fjernes fra katalogen slik at jeg ikke studerer beskrivelser som ikke kan brukes |
|
|
API-katalogen |
Som API-forvalter ønsker jeg at API-beskrivelsene skal være maskinlesbare og publisert/høstet av felles API-katalog gjennom et API eller tilsvarende slik at jeg kan vedlikeholde dokumentasjonen lokalt og ett sted. |
|
|
API-katalogen |
Som API-forvalter ønsker jeg at mine API-beskrivelser følger et standard med veiledning og verktøystøtte slik at det er enkelt for brukerne og jeg kan redusere mine forvaltningskostnader og henvendelser |
|
|
API-katalogen |
Som API-konsument ønsker jeg å kunne sammenlikne API slik at jeg kan vurdere om et API passer bedre enn et annet |
|
|
API-katalogen |
Som API-konsument ønsker jeg at datasett som er relatert til hverandre vises sammen slik at jeg kan få et helhetlig bilde av et fenomen |
|
|
API-katalogen |
Som API-forvalter ønsker jeg å tilgjengeliggjøre API-et i en sanntids-tjenestekatalog (SMP) slik at den kan brukes til capability lookup i sanntids meldingsutveksling |
|
|
API-katalogen |
Som API-forvalter ønsker jeg kontaktinfo til brukere av mine API slik at jeg kan ta kontakt med dem |
|
|
API-katalogen |
Som API-konsument ønsker jeg å beskrive standardiserte autentiserings- og autorisaksjonsmekansimer som kan gjenbrukes på tjenester beskrevet for API-ene slik at tilgangsstyring mot flere tjenester kan forenkles |
|
|
Som API-forvalter ønsker jeg at mine API-beskrivelser følger et standard med veiledning og verktøystøtte slik at det er enkelt for brukerne og jeg kan redusere mine forvaltningskostnader og henvendelser |
1.Som API-forvalter ønsker jeg at katalogen dekker informasjonsbehovet til de som skal benytte API-ene jeg forvalter, slik at jeg slipper å besvare henvendelser fra dem/redusere antall henvendelser [frigjøre ressurser] |
|
|
Som API-forvalter ønsker jeg at mine API-beskrivelser følger et standard med veiledning og verktøystøtte slik at det er enkelt for brukerne og jeg kan redusere mine forvaltningskostnader og henvendelser |
15. Som API-forvalter/eier ønsker jeg en ensartet og samlet beskrivelse av alle våre API-er slik at det er enkelt for brukerne å gjenbruke sin kunnskap om de skal bruke flere API-er. |
|
|
Som API-forvalter ønsker jeg at mine API-beskrivelser følger et standard med veiledning og verktøystøtte slik at det er enkelt for brukerne og jeg kan redusere mine forvaltningskostnader og henvendelser |
BTI004 Som API-tilbyder ønsker jeg å tilby informasjon om mine API’er i henhold til en standard for å redusere mine forvaltningskostnader, for eksempel for å få redusert manuelle henvendelser |
|
|
Som API-forvalter ønsker jeg at mine API-beskrivelser følger et standard med veiledning og verktøystøtte slik at det er enkelt for brukerne og jeg kan redusere mine forvaltningskostnader og henvendelser |
BTI005 Som API-tilbyder ønsker jeg å tilby informasjon om mine API’er i henhold til en standard for å sikre at det blir enkelt å ta API’ene i bruk slik at vi bidrar til forenkling og samordning |
|
|
Som API-forvalter ønsker jeg at mine API-beskrivelser følger et standard med veiledning og verktøystøtte slik at det er enkelt for brukerne og jeg kan redusere mine forvaltningskostnader og henvendelser |
Det er behov for enkel tilgang til data av god kvalitet, og som er beskrevet på en standardisert måte |
|
|
Som API-forvalter ønsker jeg at API-beskrivelsene skal være maskinlesbare og publisert/høstet av felles API-katalog gjennom et API eller tilsvarende slik at jeg kan vedlikeholde dokumentasjonen lokalt og ett sted. |
BAM02 - Som ansvarlig for API-management ønsker jeg å dokumentere mitt API slik at utviklere raskt kan benytte API-et for tilgang til de data API-et representerer |
|
|
Som API-forvalter ønsker jeg at API-beskrivelsene skal være maskinlesbare og publisert/høstet av felles API-katalog gjennom et API eller tilsvarende slik at jeg kan vedlikeholde dokumentasjonen lokalt og ett sted. |
12. Som APi-forvalter/eier ønsker jeg at standarder og beskrivelser er helt maskinlesbare slik at høsting og bruk kan automatiseres og min rolle automatiseres bort eller erstattes av AI. |
|
|
Som API-forvalter ønsker jeg at API-beskrivelsene skal være maskinlesbare og publisert/høstet av felles API-katalog gjennom et API eller tilsvarende slik at jeg kan vedlikeholde dokumentasjonen lokalt og ett sted. |
30. Som API-portaleier ønsker jeg at alle skal tilby sin informasjon på samme format, OG at alle har et eget API som beskriver sin katalog eller sitt API, slik at portalen enklest mulig kan høste og sammenstille informasjon om API-er. |
|
|
Som API-forvalter ønsker jeg at API-beskrivelsene skal være maskinlesbare og publisert/høstet av felles API-katalog gjennom et API eller tilsvarende slik at jeg kan vedlikeholde dokumentasjonen lokalt og ett sted. |
29. Som API-katalogeier med en eksisterende API-dokumentasjon ønsker jeg å bruke eksisterende API-dokumentasjon slik at jeg slipper å vedlikeholde API-dokumentasjon (manuelt) flere steder. |
|
|
Som API-forvalter ønsker jeg at API-beskrivelsene skal være maskinlesbare og publisert/høstet av felles API-katalog gjennom et API eller tilsvarende slik at jeg kan vedlikeholde dokumentasjonen lokalt og ett sted. |
22. Som en API-forvalter med allerede eksisterende API-katalog, ønsker jeg at løsningen er fleksibel(?)/legger til rette for automatisk høsting, slik at jeg kan vedlikeholde dokumentasjonen min lokalt. |
|
|
Som API-forvalter ønsker jeg at API-beskrivelsene skal være maskinlesbare og publisert/høstet av felles API-katalog gjennom et API eller tilsvarende slik at jeg kan vedlikeholde dokumentasjonen lokalt og ett sted. |
BAM04 - Som leverandør av API-management-verktøy ønsker jeg at jeg å kunne tilby automatisk integrasjon med den felles API-katalogen slik at jeg kan selge mer av produktet mitt ved å vise til at det støtter opp under de nasjonale føringene. |
|
|
Som API-forvalter ønsker jeg at API-beskrivelsene skal være maskinlesbare og publisert/høstet av felles API-katalog gjennom et API eller tilsvarende slik at jeg kan vedlikeholde dokumentasjonen lokalt og ett sted. |
BAM01 - Som ansvarlig for API-management ønsker jeg å publisere mine API i en API-katalog slik at utviklere raskt kan finne frem til mitt API/økt synlighet |
|
|
Som API-forvalter ønsker jeg at API-beskrivelsene skal være maskinlesbare og publisert/høstet av felles API-katalog gjennom et API eller tilsvarende slik at jeg kan vedlikeholde dokumentasjonen lokalt og ett sted. |
BAM07 - Som leverandør av API-management-verktøy ønsker jeg å kunne publisere dokumentasjon om API fra mitt API management verktøy til en felles offentlig API katalog |
|
|
Som API-konsument ønsker jeg at API-beskrivelser er oppdaterte, og at API-er som ikke lenger er tilgjengelig/deprecated fjernes fra katalogen slik at jeg ikke studerer beskrivelser som ikke kan brukes |
BA25. Som API-konsument ønsker jeg at beskrivelser av API-er som ikke lengre er tilgjengelige, skal fjernes fra API-katalogen, slik at jeg slipper å lese om API-er som jeg uansett ikke kan bruke. |
|
|
Som API-konsument ønsker jeg at API-beskrivelser er oppdaterte, og at API-er som ikke lenger er tilgjengelig/deprecated fjernes fra katalogen slik at jeg ikke studerer beskrivelser som ikke kan brukes |
BA36. Som API-konsument ønsker jeg at noen tar jobben med å holde oversikt over om API-er er tilgjengelige, utilgjengelige, stabilt, deprecated etc slik at jeg slipper å begynne å ta det i bruk først før jeg oppdager det. |
|
|
Som API-forvalter ønsker jeg en å samle beskrivelser av API-ene våre og andres slik at det er enkelt å få oversikt over API-er og bruk |
14. Som API-forvalter/eier ønsker jeg en ensartet og samlet API-katalog slik at det blir enklere å publisere informasjonen. |
|
|
Som API-forvalter ønsker jeg en å samle beskrivelser av API-ene våre og andres slik at det er enkelt å få oversikt over API-er og bruk |
28. Som API-katalogeier ønsker jeg å, slik at jeg kan ha en total oversikt over API-ene våre kunne vite hvilke API-er min virksomhet tilbyr (og forvalte de på felles måte, vite hvem som bruker hvilke API-er osv.). |
|
|
Som API-forvalter ønsker jeg en å samle beskrivelser av API-ene våre og andres slik at det er enkelt å få oversikt over API-er og bruk |
31. Som API-portaleier ønsker jeg å få inn statistikk fra API-forvaltere slik at vi kan få et overordnet oversikt for hele sektoren/landet. |
|
|
Som API-forvalter ønsker jeg en godt dokumentert felles løsning for registering av API-beskrivelser slik at jeg slipper å installere egne verktøy. |
Som API-eier ønsker jeg å kunne beskrive funksjonaliteten i API-et på en overordnet måte slik at brukere får et innblikk i hva API-et innholder. |
|
|
Som API-forvalter ønsker jeg en godt dokumentert felles løsning for registering av API-beskrivelser slik at jeg slipper å installere egne verktøy. |
Som utvikler i Altinn ønsker jeg å kunne registrere tredjepart API uten at API-eier har kjennskap til dette slik <hensikt> |
|
|
Som API-forvalter ønsker jeg en godt dokumentert felles løsning for registering av API-beskrivelser slik at jeg slipper å installere egne verktøy. |
Som utvikler i Altinn ønsker jeg å kunne registrere de API jeg utvikler for mine T.3 applikasjoner slik at <hensikt> |
|
|
Som API-forvalter ønsker jeg en godt dokumentert felles løsning for registering av API-beskrivelser slik at jeg slipper å installere egne verktøy. |
34. Som API-katalogeier som ikke har en katalog, så ønsker jeg enkel måte å eksponere API-er på, ikke egen katalog med maskinlesbar beskrivelse, slik at jeg slipper å lage et eget verktøy med egne beskrivelser. |
|
|
Som API-forvalter ønsker jeg en godt dokumentert felles løsning for registering av API-beskrivelser slik at jeg slipper å installere egne verktøy. |
9. Som API-forvalter ønsker jeg en felles løsning for API-dokumentasjon som er så god at jeg selv ønsker å bruke løsningen fremfor andre verktøy |
|
|
Som API-konsument ønsker jeg å søke og filtrere langs ulike kategorier (f.eks. formater, tilgangsnivå) på API slik at jeg minimerer tiden jeg bruker på å finne rett API |
23. Som API-forvalter ønsker jeg at de API-ene jeg tilbyr skal være lette å finne og ta i bruk for de som har verdi av dem, slik at innsatsen jeg har lagt ned i API-ene får størst mulig verdi [forsvare kostnadene ved utviklingen/forvaltningen av API-ene/generere størst mulig nytte] |
|
|
Som API-konsument ønsker jeg å søke og filtrere langs ulike kategorier (f.eks. formater, tilgangsnivå) på API slik at jeg minimerer tiden jeg bruker på å finne rett API |
24. Som API-forvalter (f.eks. av hotell.difi.no) ønsker jeg at API-ene er lette å finne og ta i bruk slik at verdien blir realisert. |
|
|
Som API-konsument ønsker jeg å søke og filtrere langs ulike kategorier (f.eks. formater, tilgangsnivå) på API slik at jeg minimerer tiden jeg bruker på å finne rett API |
BFDK02 - Som forretningsutvikler ønsker jeg å søke etter API, slik at jeg raskt kan finne ut om det finnes data jeg kan gjenbruke |
|
|
Som API-konsument ønsker jeg å søke og filtrere langs ulike kategorier (f.eks. formater, tilgangsnivå) på API slik at jeg minimerer tiden jeg bruker på å finne rett API |
35. Som API-katalogeier ønsker jeg å kategorisere API-innslagene, slik at det kan differensieres mellom de. |
|
|
Som API-konsument ønsker jeg å søke og filtrere langs ulike kategorier (f.eks. formater, tilgangsnivå) på API slik at jeg minimerer tiden jeg bruker på å finne rett API |
BA1. Som API-konsument (student) ønsker jeg å filtrere på dataformater i oversikter over (åpne) API-er slik at jeg kan finne API-er i det formatet jeg ønsker å lære mer om eller filtrere ut de jeg ikke kan noe om. |
|
|
Som API-konsument ønsker jeg å søke og filtrere langs ulike kategorier (f.eks. formater, tilgangsnivå) på API slik at jeg minimerer tiden jeg bruker på å finne rett API |
Som API-katalogeier ønsker jeg å kategorisere API-innslagene, slik at det kan differensieres mellom de. |
|
|
Som API-konsument ønsker jeg å søke og filtrere langs ulike kategorier (f.eks. formater, tilgangsnivå) på API slik at jeg minimerer tiden jeg bruker på å finne rett API |
BB8. Som API-konsument ønsker jeg at utforskingsfasen/exploration/discovery gir meg rask oversikt og innsikt slik at jeg minimerer tiden jeg bruker på å velge et utsnitt eller må bruke egne verktøy for å skaffe meg oversikt. [dokumentasjon] |
|
|
Som API-konsument ønsker jeg at API-er av autoritativ art priorites slik at de er lette å finne |
25. Som API-forvalter som forvalter API-er til autoritative data ønsker jeg at API-katalogen skal prioritere presentasjon av mine API-er fremfor API-er som tilbyr samme data, men fra ikke-autoritative kilder, slik at API-brukerne ikke ubevisst bruker ikke-autoritative data |
|
|
Som API-konsument ønsker jeg å se request og respons på et API slik at jeg kan planlegge design |
BFDK06 - Som arkitekt ønsker jeg å se hvilke data jeg må benytte for å gjøre oppslag mot et API og hvilke data jeg får tilbake slik at jeg kan planlegge design av løsning. |
|
|
EPOS 4: Som API-konsument ønsker jeg å finne detaljert beskrivelse av API-ene slik at jeg kan vurdere om jeg kan benytte API-et i mine tjenester |
BFDK03 - Som forretningsutvikler ønsker jeg å se detaljerte beskrivelser av APIene, slik at jeg kan vurdere om de er av tilstrekkelig kvalitet for bruk i mine tjenester |
|
|
EPOS 4: Som API-konsument ønsker jeg å finne detaljert beskrivelse av API-ene slik at jeg kan vurdere om jeg kan benytte API-et i mine tjenester |
Datakonsumenter har behov for et ryddig avtaleregime for tilgang til dataene. |
|
|
Som API-forvalter ønsker jeg at API-katalog kan plukke opp min swagger dokumentasjon slik at jeg kan benytte dette verktøyet |
5. Som API-forvalter ønsker jeg at API-katalogen kan vise min Swagger-dokumentasjon slik at jeg bare kan eksponere for eksempel Swagger-data (YAML) og slipper å drifte min egen Swagger UI-nettside. [relatert til Swagger-brukerhistorien, trur eg] |
|
|
Som API-forvalter ønsker jeg at API-katalog kan plukke opp min swagger dokumentasjon slik at jeg kan benytte dette verktøyet |
7. Som API-forvalter har jeg behov for å selv velge hvor selve dokumentasjonen skal ligge, slik at jeg kan bruke de verktøyene som er mest hensiktsmessig til formålet. |
|
|
Som dataeier ønsker jeg å knytte API til datasettet slik at jeg kan vise hvilke distribusjoner som finnes |
BFDK07 - Som datasetteier (og som beskriver datasett i datakatalogen) ønsker jeg å kunne kople beskrivelser av APIer (i flertall) til et gitt datasett, slik at jeg kan vise hvilke distribusjoner som finnes av et datasett |
|
|
Som forretningsutvikler ønsker jeg å se filtrere på datasett som tilbyr API slik at jeg kan benytte det i mine tjenester |
BFDK01 - Som forretningsutvikler ønsker jeg å se hvilke datasett som tilbyr API, slik at jeg kan vurdere om det kan brukes i mine tjenester. |
|
|
Som forretningsutvikler ønsker jeg å se filtrere på datasett som tilbyr API slik at jeg kan benytte det i mine tjenester |
BFDK04 - Som forretningsutvikler ønsker jeg å filtrere på datasett som har API, slik at jeg bedre treff på mine søk i katalogen. |
|
|
Som dataeier ønsker jeg at relevante opplysninger fra API-beskrivelsen er tilgjengelig i datasettbeskrivelsen slik at jeg unngår dobbeltarbeid |
BFDK08 - Som datasetteier (som beskriver datasett i datakatalogen) ønsker jeg å kunne plukke fra API-beskrivelsen dataelementene som jeg ønsker å ta med i datasettbeskrivelsen, slik at dataelementene jeg tar med gjenspeiler det som APIet virkelig kan tilby. |
|
|
Som dataeier ønsker jeg at relevante opplysninger fra API-beskrivelsen er tilgjengelig i datasettbeskrivelsen slik at jeg unngår dobbeltarbeid |
26. Som API-forvalter ønsker jeg at opplysninger som er relevante for datakatalogen og som finnes i API-et (feks “sist oppdatert”), høstes til datakatalogen slik at datasettbeskrivelsen er så god som mulig. |
|
|
Som API-eier ønsker jeg å publisere API-er som ikke kan knyttes til et datasett slik at også mine mine API-er som gjør beregninger e.l. kan publiseres |
Som API-eier ønsker jeg å kunne beskrive et API som ikke nødvendigvis kan knyttes til et datasett, slik at også dynamiske tjenester kan synliggjøres for andre konsumenter. |
|
|
Som API-konsument ønsker jeg å kunne gi komme i dialog med API-eier og andre API-konsumenter og gi tilbakemeldinger, tips, stille spørsmål, melde om feil, gi innspill til endringer slik at dette kan hver til hjelp for meg, andre og data-eier. |
BB19. Som API-konsument ønsker jeg å diskutere semantiske og tekniske spørsmål i en åpen kanal (wiki, github issues el liknende) for APIet jeg bruker, slik at brukerne kan hjelpe hverandre og tilbyder kan kommunisere åpent med sitt økosystem. [nettverk, dokumentasjon] |
|
|
Som API-konsument ønsker jeg å kunne gi komme i dialog med API-eier og andre API-konsumenter og gi tilbakemeldinger, tips, stille spørsmål, melde om feil, gi innspill til endringer slik at dette kan hver til hjelp for meg, andre og data-eier. |
BA22. Som API-konsument (app-utvikler) ønsker jeg en landingsside hvor jeg kan stille spørsmål om bruk av API-et slik at jeg kan bruke det mest mulig hensiktsmessig, og gjerne med henvisninger til kjent brukt av API-et. |
|
|
Som API-konsument ønsker jeg å kunne gi komme i dialog med API-eier og andre API-konsumenter og gi tilbakemeldinger, tips, stille spørsmål, melde om feil, gi innspill til endringer slik at dette kan hver til hjelp for meg, andre og data-eier. |
21. Som API-forvalter ønsker jeg å få en effektiv kanal for å få tilbakemeldinger og behov fra de som bruker API-ene mine, slik at det blir lettere å prioritere riktig ved videreutvikling av API-ene [styrke dialog med brukerne av API-ene] |
|
|
Som API-konsument ønsker jeg å kunne gi komme i dialog med API-eier og andre API-konsumenter og gi tilbakemeldinger, tips, stille spørsmål, melde om feil, gi innspill til endringer slik at dette kan hver til hjelp for meg, andre og data-eier. |
BA6. Som API-konsument ønsker jeg å kunne på en enkel måte gi kontekstavhengige tilbakemeldinger til API-forvalteren, slik at dokumentasjonen og eller API-et blir bedre. |
|
|
Som API-konsument ønsker jeg å kunne gi komme i dialog med API-eier og andre API-konsumenter og gi tilbakemeldinger, tips, stille spørsmål, melde om feil, gi innspill til endringer slik at dette kan hver til hjelp for meg, andre og data-eier. |
BA52. Som API-konsument ønsker jeg en enkel måte å rapportere inn feil i datakatalog (f.eks. Lenker som ikke fungerer) slik at jeg slipper å bla i utdatert innhold. |
|
|
Som API-konsument ønsker jeg å kunne gi komme i dialog med API-eier og andre API-konsumenter og gi tilbakemeldinger, tips, stille spørsmål, melde om feil, gi innspill til endringer slik at dette kan hver til hjelp for meg, andre og data-eier. |
BB11. Som API-konsument (analytiker) ønsker jeg mulighet for å legg inn spørsmål, tips, eksempler knyttet til APIer slik at jeg kan øke min egen, andre brukere og api-forvalternes kjennskap om semantikk, selve APIen og bruk [økosystem] |
|
|
Som API-konsument ønsker jeg å kunne gi komme i dialog med API-eier og andre API-konsumenter og gi tilbakemeldinger, tips, stille spørsmål, melde om feil, gi innspill til endringer slik at dette kan hver til hjelp for meg, andre og data-eier. |
20. Som API-forvalter ønsker jeg at brukerne av mitt API skal ha en åpen kommunikasjon med meg og hverandre om hvilke behov de har som ikke er dekket i dag, slik at min videreutvikling treffer flest mulig brukere på en tilstrekkelig måte. |
|
|
Som API-konsument ønsker jeg å kunne gi komme i dialog med API-eier og andre API-konsumenter og gi tilbakemeldinger, tips, stille spørsmål, melde om feil, gi innspill til endringer slik at dette kan hver til hjelp for meg, andre og data-eier. |
BA50. Som API-konsument, ønsker jeg å kunne gi tilbakemeldinger til god (eller dårlig) “beste praksis” for API-er, slik at dette kan være til hjelp for framtidige API-er som utvikles. |
|
|
Som API-konsument ønsker jeg å kunne gi komme i dialog med API-eier og andre API-konsumenter og gi tilbakemeldinger, tips, stille spørsmål, melde om feil, gi innspill til endringer slik at dette kan hver til hjelp for meg, andre og data-eier. |
BA51. Som API-konsument ønsker jeg mulighet til å gi tilbakemeldinger slik at jeg kan melde fra om feil eller foreslå forbedringer |
|
|
Som API-konsument ønsker jeg å kunne gi komme i dialog med API-eier og andre API-konsumenter og gi tilbakemeldinger, tips, stille spørsmål, melde om feil, gi innspill til endringer slik at dette kan hver til hjelp for meg, andre og data-eier. |
BAM13 - Som ansvarlig for API-management ønsker jeg at brukerne av mine API-er skal kunne gi innspill til endringer av mine API-er, slik at jeg gjøre API-ene mine mer brukervennlige. |
|
|
Som API-konsument ønsker jeg å kunne gi komme i dialog med API-eier og andre API-konsumenter og gi tilbakemeldinger, tips, stille spørsmål, melde om feil, gi innspill til endringer slik at dette kan hver til hjelp for meg, andre og data-eier. |
Som API-forvalter ønsker jeg å kunne motta strukturerte tilbakemeldinger (f.eks. feil) og endringsforslag for mine tjenester slik at tjenestene kan forbedres |
|
|
Som API-konsument ønsker jeg å kunne gi komme i dialog med API-eier og andre API-konsumenter og gi tilbakemeldinger, tips, stille spørsmål, melde om feil, gi innspill til endringer slik at dette kan hver til hjelp for meg, andre og data-eier. |
Som API-konsument ønsker jeg å kunne gi strukturerte tilbakemeldinger (f.eks. feil) og endringsforslag for tjenester slik at tjenestene kan forbedres |
|
|
Som API-konsument ønsker jeg kunnskapsbase (f.eks. FAQ funksjonalitet) slik at jeg som bruker kan få svar på kjente utfordringer og ikke behøver å bruke tid på henvendelser |
10. Som en API-forvalter ønsker jeg å kunne ha “FAQ-funksjonalitet” (eller kunnskapsbase), slik at brukerne mine lettere kan få tak i svar på kjente utfordringer og jeg kan redusere kostnader ved å håndtere brukerhenvendelser. |
|
|
Som API-forvalter ønsker jeg å kjenne til brukere av API slik at jeg kan formidle endringer i API-et |
17. Som API-forvalter ønsker jeg å vise frem eksempel på bruk av mine API-er slik at verdien av API-ene blir synliggjort og det kan inspirere flere til å bruke API-ene og hvordan bruke API-ene. |
|
|
Som API-forvalter ønsker jeg å kjenne til brukere av API slik at jeg kan formidle endringer i API-et |
32. Som API-bruker ønsker jeg å registrere en anvendelse slik at jeg kan oppgi den i API-kallet. Alternativt: Som API-forvalter ønsker jeg at brukere kan registrere seg med en ID som de bruker i API-kallet slik at jeg kan koble trafikk og anvendelse. [f.eks. ved overbruk av API-et kan man lett kontakte den som har satt opp anvendelsen] |
|
|
Som API-forvalter ønsker jeg å kjenne til brukere av API slik at jeg kan formidle endringer i API-et |
18. Som API-forvalter ønsker jeg oversikt over integrasjoner mot mine API-er slik at konsekvenser og kostnader ved endringer kan forutses og minimeres. |
|
|
Som API-forvalter ønsker jeg å kjenne til brukere av API slik at jeg kan formidle endringer i API-et |
BA14. Som API-konsument ønsker jeg lenker til applikasjoner som bruker datasettet, slik at jeg kan finne gode eksempler på bruk av API-et og datasettet. [kommentar: også programvarebibliotek og anna kodeverk som er relevant |
|
|
Som API-forvalter ønsker jeg å kjenne til brukere av API slik at jeg kan formidle endringer i API-et |
BAM08 - Som ansvarlig for API-management ønsker jeg oversikt over brukerne av mitt API slik at jeg kan formidle endringer i APIet. [Livar: duplikat av BAM03?] |
|
|
Som API-forvalter ønsker jeg å kjenne til brukere av API slik at jeg kan formidle endringer i API-et |
16. Som API-forvalter ønsker jeg å vite av hvem og hvor ofte mine API-er brukes (trafikkdata og bruksmønstre), slik at jeg optimere tilgang til API-er og ta stilling til hvilke API-er som eventuelt skal avvikles, samt kunne få grunnlag for å kunne rapportere på gevinstrealisering. |
|
|
Som API-forvalter ønsker jeg å kjenne til brukere av API slik at jeg kan formidle endringer i API-et |
BB20. Som API-konsument ønsker jeg eksempel på bruk av dataene som en del av dokumentasjonen av API-et, slik at de er enklere å fortså og ta i bruk [dokumentasjon] |
|
|
Som API-konsument ønsker jeg å bli varslet om endringer i API slik at jeg kan tilpasse meg endringer |
BAM03 - Som ansvarlig for API-management ønsker jeg å notifisere endringer i mine API til dem som benytter API-ene slik at man ikke bryter kontrakter |
|
|
Som API-konsument ønsker jeg å bli varslet om endringer i API slik at jeg kan tilpasse meg endringer |
BA42. Som API-konsument ønsker jeg varsler om “breaking changes” slik at jeg kan gjøre de nødvendige endringene før de brekker mine systemer/applikasjoner også. [f.eks. ved registrere e-postadresse] |
|
|
Som API-konsument ønsker jeg å bli varslet om endringer i API slik at jeg kan tilpasse meg endringer |
BA43. Som API-konsument ønsker jeg å bli varslet om at et API er “deprecated” (skal tas ut av bruk), slik at jeg kan oppdatere min applikasjon. |
|
|
Som API-konsument ønsker jeg å bli varslet om endringer i API slik at jeg kan tilpasse meg endringer |
Som API-forvalter ønsker jeg en enkel måte å varsle endringer spesifikasjon av tjenester |
|
|
Som API-konsument ønsker jeg å bli varslet om endringer i API slik at jeg kan tilpasse meg endringer |
BFDK11 - Som konsument ønsker jeg å abonnere på varslinger om etablering, endring, driftsstans og avvikling av API’er slik at jeg kan tilpasse meg endringer |
|
|
Som API-konsument ønsker jeg å bli varslet om endringer i API slik at jeg kan tilpasse meg endringer |
Som ansvarlig for API-Management ønsker jeg en enkel måte å varsle endringer i oppetid |
|
|
Som API-konsument ønsker jeg å bli varslet om endringer i API slik at jeg kan tilpasse meg endringer |
Som API-forvalter/ansvarlig for API-management ønsker jeg en enkel måte å kommunisere livssyklus planer og garantier for en tjeneste (f.eks. nedleggelse/utfasing) slik at jeg kan avvikle tjenester når det er ønskelig |
|
|
Som API-konsument ønsker jeg å bli varslet om endringer i API slik at jeg kan tilpasse meg endringer |
Som potensiell API-konsument ønsker jeg å kjenne til livssyklus planer og garantier for en tjeneste (f.eks. nedleggelse/utfasing) slik at jeg ikke gjør meg avhengig av eksterne APIer som kan forsvinne |
|
|
Som API-konsument ønsker jeg å kunne sammenlikne API slik at jeg kan vurdere om et API passer bedre enn et annet |
BFDK05 - Som forretningsutvikler ønsker jeg å kunne sammenligne APIere, slik at jeg vurdere om et API passer bedre enn et annet for min bruk. |
|
|
Som API-konsument ønsker jeg at datasett som er relatert til hverandre vises sammen slik at jeg kan få et helhetlig bilde av et fenomen |
BFDK09 - Som datasetteier for historiske (avleverte) data ønsker jeg å kunne koble de historiske datasettene med tilsvarende aktive/nåværende datasett, slik at jeg kan tilby brukerne en helhetlig tilgang til dataene. |
|
|
Som API-konsument ønsker jeg at datasett som er relatert til hverandre vises sammen slik at jeg kan få et helhetlig bilde av et fenomen |
BB10. Som API-konsument ønsker jeg mulighet til å innhente data om tekstdatasett slik at jeg kan lage analyser av disse og koble til andre kilde. [tekst som data] |
|
|
Som API-konsument ønsker jeg at datasett som er relatert til hverandre vises sammen slik at jeg kan få et helhetlig bilde av et fenomen |
BA20. Som API-konsument ønsker jeg informasjon om hvor jeg kan finne statiske data som brukes til API-requests (Kommunenr, Kommunenavn..) slik at jeg slipper å lete etter dette selv. |
|
|
Som API-forvalter ønsker jeg kontaktinfo til brukere av mine API slik at jeg kan ta kontakt med dem |
19. Som API-forvalter ønsker jeg kontaktinfo til de som bruker mine API slik at jeg kan ta kontakt med de om brukerundersøkelser, driftsmeldinger, endring av API, nye API og liknande. [dersom jeg ikke har egne løsninger for dette allerede] |
|
|
Som API-forvalter ønsker jeg kontaktinfo til brukere av mine API slik at jeg kan ta kontakt med dem |
Som API-forvalter/API-Management ansvarlig ønsker jeg en enkel måte å kommunisere informasjon rettet til enkeltbrukere av tjenester |
|
|
Som API-forvalter ønsker jeg kontaktinfo til brukere av mine API slik at jeg kan ta kontakt med dem |
Som API-forvalter/API-Management ansvarlig ønsker jeg en enkel måte å kommunisere sensitiv informasjon sikkert til (enkelt)brukere av tjenester |
|
|
Som API-forvalter ønsker jeg å tilgjengeliggjøre API-et i en sanntids-tjenestekatalog (SMP) slik at den kan brukes til capability lookup i sanntids meldingsutveksling |
Som API-eier ønsker jeg å angi at API’et skal være tilgjengelig i en runtime-tjenestekatalog (SMP/capability lookup) og Altinn tjenestekatalog/Authorization for samtykke og tilgangsstyring. |
|
|
Som API-forvalter ønsker jeg å tilgjengeliggjøre API-et i en sanntids-tjenestekatalog (SMP) slik at den kan brukes til capability lookup i sanntids meldingsutveksling |
Som API-forvalter ønsker jeg å kunne få overført mine API-definisjoner til en runtime tjenestekatalog (SMP, CapabiliityLookup eller den tekniske endepunktedelen av KoFuVi?) for å kunne legge til metadata for runtime-kall slik at jeg ikke må registrere mine API-definisjoner dobbelt. |
|
|
Som API-konsument ønsker jeg at distribusjoner av samme (eller geografisk komplementære) datasett fra ulike tilbydere eller er samlet under et datasett |
BTI010 Som API-tilbyder ønsker jeg å kunne se om andre tilbyr det samme eller nesten det samme som meg, så at det er mulig å harmonisere mellom “oss” [Livar: Case der det er fleire API-er som tilbyr det samme? Marit: Brreg og Skatt som har same datasett i FDK. Mathias: Felles studentsystem (FS) i UH-sektoren innheld personinformasjon. Kan ikkje konsoliderast med HR-data. Kan ikkje legge ned ein av dei. Dekker relasjonsfeltet i DCAT behovet?] |
|
|
Som bruker ønsker jeg å kunne authentisere meg på en enkel måte mot katalogen slik at jeg kan gi tilbakemeldninger og melde om bruk av et API |
BAM17 - Som ansvarlig for API-management ønsker jeg at å tilby effektiv selvregistrering av brukere av API-ene, f.eks. gjennom autentisering via ID-porten/Altinn av dem som tar i bruk API-ene, slik at jeg senker terskelen for å ta API-et i bruk, samtidig som jeg beholder nødvendig oversikt over brukere. |
|
|
Som API-konsument ønsker jeg å beskrive standardiserte autentiserings- og autorisaksjonsmekansimer som kan gjenbrukes på tjenester beskrevet for API-ene slik at tilgangsstyring mot flere tjenester kan forenkles |
Som API-konsument ønsker jeg standardiserte autentiserings- og autoriseringsmekanismer som kan gjenbrukes for flere tjenester |
|
|
Som API-konsument ønsker jeg å beskrive standardiserte autentiserings- og autorisaksjonsmekansimer som kan gjenbrukes på tjenester beskrevet for API-ene slik at tilgangsstyring mot flere tjenester kan forenkles |
Som API-konsument ønsker jeg single sign on (SSO) mellom flere tjenester jeg benytter slik at jeg unngår separat autentisering mot hver enkelt tjeneste |
|
|
Som API-konsument ønsker jeg å beskrive standardiserte autentiserings- og autorisaksjonsmekansimer som kan gjenbrukes på tjenester beskrevet for API-ene slik at tilgangsstyring mot flere tjenester kan forenkles |
Som API-konsument ønsker jeg at nasjonal/delt infrastruktur tilbyr felles mønstre for autentisering og autorisering mot API slik at jeg slipper å bestille og forvalte tilgangsstyring hos hver enkelt tjenestetilbyder. |
|
|
Som API-konsument ønsker jeg å beskrive standardiserte autentiserings- og autorisaksjonsmekansimer som kan gjenbrukes på tjenester beskrevet for API-ene slik at tilgangsstyring mot flere tjenester kan forenkles |
Som API-forvalter/API-management ansvarlig ønsker jeg en nasjonal/delt infrastruktur for administrasjon og utstedelse av tilgangstokens for API-konsumenter slik at jeg slipper å utstede og forvalte disse selv (dette gjelder både hjemmelsbasert og samtykkebasert tilgang). |
|
|
Som API-konsument ønsker jeg å beskrive standardiserte autentiserings- og autorisaksjonsmekansimer som kan gjenbrukes på tjenester beskrevet for API-ene slik at tilgangsstyring mot flere tjenester kan forenkles |
Som API-forvalter ønsker jeg at definerte APIer i API-katalogen kan overføres til felleskomponenter for tilgangsstyring og autentisering slik at jeg slipper å registrere disse dobbelt (og dermed risikere feil i registreringer) |
|
|
Som API-konsument ønsker jeg å beskrive standardiserte autentiserings- og autorisaksjonsmekansimer som kan gjenbrukes på tjenester beskrevet for API-ene slik at tilgangsstyring mot flere tjenester kan forenkles |
BAM09 - Som ansvarlig for API-management ønsker jeg å kunne administrere nøkler gitt til de enkelte konsumentene slik at jeg enkelt kan fjerne ev. misbruk av API-et |
|
|
Som API-konsument ønsker jeg å beskrive standardiserte autentiserings- og autorisaksjonsmekansimer som kan gjenbrukes på tjenester beskrevet for API-ene slik at tilgangsstyring mot flere tjenester kan forenkles |
BA2. Som API-konsument ønsker jeg umiddelbar tilgang (slipper å vente på manuell tildeling av API-nøkler og tokens) til data (eller testdata) slik at jeg kan vurdere og eventuelt ta i bruk API-et umiddelbart. |
|
|
Som API-konsument ønsker jeg å beskrive standardiserte autentiserings- og autorisaksjonsmekansimer som kan gjenbrukes på tjenester beskrevet for API-ene slik at tilgangsstyring mot flere tjenester kan forenkles |
BA34. Som API-konsument ønsker jeg at eventuelle krav til API-nøkler etc lar seg løse raskt/selvbetjent slik at jeg kan komme i gang raskt. [f.eks. autorisering basert på eksisterende mekanismer fremfor å måtte kontakte forvalter og vente på svar (ID-porten, Altinn), bruksvilkår fremfor avtaler] |
|
|
Som API-konsument ønsker jeg å beskrive standardiserte autentiserings- og autorisaksjonsmekansimer som kan gjenbrukes på tjenester beskrevet for API-ene slik at tilgangsstyring mot flere tjenester kan forenkles |
Datakonsumenter har behov for tilgang til dataene på en enkel og standardisert måte. |
|
|
Som API-konsument ønsker jeg kontaktinformasjon til brukerstøtte for API slik at jeg kan få hjelp om jeg står fast |
BFDK12 - Som konsument ønsker jeg kontaktinformasjon til brukerstøtte for API slik at jeg kan få hjelp |