Open willebra opened 6 years ago
Pull Request https://github.com/okffi/open-api-definition/pull/42 liittyy tähän issueen.
Avoin rajapinta on rajapinta, jonka kaikki ominaisuudet ovat julkisia ja jota voi käyttää ilman rajoittavia ehtoja (esimerkiksi laatia rajapintaa hyödyntävän ohjelman ilman rajapinnan valmistajan erillistä hyväksyntää tai pakollisia lisenssimaksuja). Avoimen rajapinnan data on lisensoitu avoimella lisenssillä.
Muut variaatiot ovat kaupallista toimintaa: sisällöstä veloitetaan tai pääsystä veloitetaan. Nämä muut variaatiot eivät ole muuta kuin kaupallisia (usein myös julkisia) rajapintoja (kumppanirajapinta, maksukerros-API ilman ilmaiskerrosta). Näin määrittäen ei jää epäselvyyttä.
Toki avoimen rajapinnan käyttömäärää voidaan rajoittaa (esim ratelimiting), muttei kokonaan estää. Mutta rajapinta jota saa käyttää vapaasti, mutta jonka sisältöä et ilman esimerkiksi maksua saa käyttää, ei eroa rajapinnasta joka vaatii maksun sisäänpäästämisestä eli siitä että saat tehdä kutsuja rajapintaan.
Haluaisin kommentteja avoimen rajapinnan määritelmään, kohtaan: "Kommentti: Rajapinnan dokumentaatiosta ja testiaineistoista ei peritä maksua, mutta palvelun varsinaiseen tietosisältöön käsiksi pääsemisestä voidaan periä myös maksu, vaikka rajapinta olisi avoin." Tämä on liian laajasti/yksisilmäisesti sanottu, mutta taustalla on käsittääkseni myös oikeita huolia. Kohdan ymmärtää helposti liian laajasti ja tähän liittyy kysymys rajapinnan ja datan avoimuuksien erosta (avoin rajapinta, suljettu data).
Miten näette avoimen rajapinnan määritelmän suhteessa seuraaviin:
Tämä liittyy pull requestiin: https://patch-diff.githubusercontent.com/raw/okffi/open-api-definition/pull/42.patch
Tämä liittyy myös määritelmän myöhempään kohtaan, jossa sanotaan:
Voidaanko pitää tällainen selkeä erottelu rajapinnan ja datan välillä? Entä mikäli erottelu on näin, tulisiko jotenkin selkeyttää sitä, miten nimitetään sellaisia avoimia rajapintoja, joissa sisältö on täysin suljettu?