APIs.guru — julkisia API:en swagger spesifikaatioita

Screenshot from 2016-01-04 11:11:06

Törmäsin joululomalla apis.guru konseptiin, jossa ajatuksena on listata API:en Swagger 2.0 spesifikaatioita githubissa ainakin näin alkuun. Github on loistava palvelu, mutta en sen listaukseen ollut ihan tyytyväinen miellyttävyyden ja käytettävyyden kannalta, joten tein kokeellisen listauksen jQueryllä. Mitään suurta toiminnallisuutta en ajatellutkaan tehdä, vain kokeilun. Koodi millä tulos(http://apisuomi.fi/apis/apis.guru/) syntyy on kohtalaisen simppeli ja viimeistelemätön (gist).

Screenshot from 2016-01-04 11:38:26

Jokaisesta API:sta listataan:

  • logo jos on
  • versio tieto
  • kuvaus
  • linkki Swagger 2.0 spesifikaatioon
  • linkki API:in.

Kävin githubissa asiasta keskustelua myös apis.guru konseptin omistajan kanssa. Meillä molemmilla tuntuu olevan samoja ajatuksia sen suhteen minkä tyyppinen palvelu lopulta voisi olla. Itse kutsun visiota palvelusta “APIverse” nimellä. Ajatuksena on tarjoilla API:en kehittäjille saman tyyppinen palvelu kuin mitä Thingiverse.com on 3D -printtaajille. Pidän apis.guru palvelun Ivan Goncharov:n kanssa skype palaverin tammikuussa, missä mietimme yhteistä tiekarttaa eteenpäin.