API:Suomi 2.0 siirtymä on alkanut. Siirtyminen uuteen aikaan tapahtuu vaiheittain ja kestää hetken. Tavoite on, että 1.4.2017 siirtyminen on valmis. API:Suomi tulee käyttämään kahta palvelua uutisten ja rajapintojen hallintaan ja julkaisuun. Blogit tulevat olemaan lähtökohtaisesti Medium alustalla.
Yhteisön jäsenet ovat tervetulleita kirjoittamaan rajapintoihin liittyviä tarinoita yhteisen API:Suomi brändin alle.
API -katalogi tulee muodostumaan APInf -API hallinnan päälle. Alla tarkemmat tiedot palveluista ja niiden käytöstä.
Vaihe 1: Blogautukset medium alustalle
Yksi osa siirtymää on blogin siirto Medium alustalle. Alusta mahdollistaa sujuvan yhteiskirjoittamisen ja avaa helpon tavan yhteisölle kirjoittaa aihepiiriin sopivia tarinoita yhteisen brändin alle. Tämä vaihe on nyt tehty alustavasti. Tuunaamme vielä ulkoasua ja tuomme näkyviin ainakin API-manifestin, avoimen rajapinnan määritelmän ja APIOps yhteisön.
Yhteisö voi luonnillisesti kirjoittaa blogejaan muualle ja linkittää sisältöä API -katalogiin. Tämä mahdollistaa API:en profiilin rikastamisen siihen liittyvillä kehittäjätarinoilla, uutisilla, youtube -videoilla ja muulla sisällöllä.
Vaihe 2: API:t katalogiin ja hallinnan piiriin
Samalla siirrämme API -katalogin API-hallinnan piiriin, joka sisältää myös katalogin. API -hallinta perustuu avoimen lähdekoodin APInf -ratkaisuun.
API:Suomi katalogi tulee löytymään osoitteesta: https://apinf.io omana organisaationaan
Jatkossa yhteisö voi tuoda omat avoimet rajapintansa API:Suomi hallintaratkaisun piiriin ilman kustannuksia.
Tuo avoimet rajapintasi yhteiseen katalogiin
API:Suomi katalogissa olevat API:t siirtyvät katalogiin ja niiden hallinta on muualla. Vaikka nyt laitamme kaikki API:t API:Suomi organisaation alle, voidaan ne jatkossa helposti siirtää omien organisaatioiden alle muutamalla kliksauksella.
Jatkossa yhteisö voi tuoda omat rajapintansa API:Suomi hallintaratkaisun piiriin ilman kustannuksia. Hallinta mahdollistaa käytönseurannan ja rajoittamisen mikäli API:n omistaja niin haluaa.
Kansallisen palveluväylän rajapinnat
APInf tiekartassa on jo näkyvissä harvester komponentti, joka hakee listan muun muassa liityntäkatalogista löytyvistä rajapinnoista ja lisää ne katalogiin avoimien rajapintojen lomaan.
REST, MQTT, Github
Alusta tukee nyt REST rajapintoja, mutta tuki MQTT reaaliaikarajapinnoille on tulossa lähiaikoina. Alusta sisältää käyttäjien- ja roolienhallinnan sekä organisaatiotuen. Kirjautuminen palveluun tapahtuu joko alustalle tehtävillä tunnuksilla tai Github -tunnuksilla.
Rikastettu API -profiili
Kuten aiemmin tuli mainittua, jokaisen API:n esittelysivuun voidaan liittää siihen liittyvää materiaalia rikastamaan ja helpottamaan kehittäjäkokemusta. API:n dokumentaatio voidaan tuottaa Swaggerin avulla tai linkkinä ulkoiseen dokumentaatioon.
