search

okffi / open-api-definition

Community governed definition of open API
http://okffi.github.io/open-api-definition/
Creative Commons Zero v1.0 Universal
7 stars 7 forks source link

Dumppi-haun edellyttäminen kaikelle avoimelle datalle? #16

Closed Mygee closed 8 years ago

Mygee commented 8 years ago

Pitäiskö olla määritelmässä mukana?

apoikola commented 8 years ago

Saattaa sekoittua avoimen datan ja avoimen APIn määritelmä. APIhan voi olla toiminnallisuuksiiltaan suppea tai laaja, mutta silti avoin.

Se onkin tietty hyvä kysymys, että onko riskinä, että jengi tehtailisi tarkoituksella liian suppeita APIa ja jättäisi relevantteja toiminnallisuuksia kuten datadumpin pois?

Joka tapauksessa IMHO data dump ei ole must have kamaa.

d2s commented 8 years ago

Kaiken datan irroittaminen järjestelmästä ei ole edes avoimen rajapinnan tavoitteiden mukaista, koska useiden järjestelmien (sekä bisnesmallien) kannalta järkevämpää on käyttää rajapintaa kuin alkaa tarjota 'täydellistä' kopiota datan sisällöstä. Data exporttien ongelma on usein siinä että ne ovat usein käytännön tasolla lähempänä raportteja, sillä alkuperäisissä tietokanta-pohjaisissa järjestelmissä data on yleensä hajautettuna eri paikkoihin. Data export ei siis välttämättä sisällä sellaisenaan käyttökelpoista rakennetta datasetille, vaikka se (esimerkiksi) JSON-muotoisena olisikin koneellisesti käsiteltävissä.

Mygee commented 8 years ago

Joku oli kuulema valittanut tästä, joten nyt tämä on täällä käsiteltynä (ja dokumentoituna). Eli alkuperäinen kommentti tarkoitti, että rajapinnan takana oleva data olisi saatavissa ajatuksella "select *" -> eli kaikki rajapinnan tarjoama data.

d2s commented 8 years ago

Osa rajapinta-toteutuksista (kuten GraphQL) mahdollistavat isojenkin datamäärien exporttaamisen jos hakuparametrit ovat liian laajat. Keskeisin ongelma on kuitenkin se että tuollaisen salliminen aiheuttaa monessa tapauksessa huomattavia suorituskyky-ongelmia. Export-mahdollisuus kaikesta datasta kerralla voi olla hyvä ominaisuus, mutta sen vaatiminen ei edistä tavoitteita rajapintojen määrän lisäämisestä.

jjaone commented 8 years ago

Jos rajapinnan kautta saatavilla oleva data on jo avointa (kuten tämän issuen otsikosssa lukee), ei sitä tarvitse API:n kautta olla kokonaisuudessaan exportattuna tarjollaa. Erillinen linkki "koko daravarantoon" riittää tai se on tarjottu saataville samasta paikasta kuin muukin data ja siis rakenteisempana ja/tai elementteinä API:sta..

Mygee commented 8 years ago

Käsitelty ja dokumentoitu.