API-seminaari: Aapo Rista ja Ville Koivunen - 6Aika, rajapintojen työkalut

Transcript

1. RAJAPINTOJEN   TYÖKALUT   Määri4elytyö  &  kirjoi4aminen  
2. 6Aika  todella  lyhyes/   •  yhteistyöhanke,  kuusi  väestömäärältään   suurinta  kaupunkia   •  Me  määri4elemme  sen  sisällä  yhteisiä   rajapintoja  
3. Tiedon  kerääminen   •  Selvitystyö  on  suurin  ja  tärkein  homma   •  Haasta4eluja   •  Meilailua   •  Työlounaita   •  Työpajoja  yritysten  ja  kunIen  kanssa   •  Eri  rajapinnoilla  erilaiset  lähtökohdat   •  Lopulta  päähän  ja  Google  Driveen  kertyy  jonkinlainen   käsitys  
4. Valitut  rajapinnat   •  Palauterajapinta   •  Alkuehtona  olemassa  oleva  Open311   •  Linked  Events  –tapahtumarajapinta   •  Linked  Events  rajapinta  jo  käytössä,  dokumentoidaan   •  Päätösrajapinta   •  VaaIi  kaupungeilta  rakenteista  päätösIetoa   •  Resurssienvaraus   •  VaaIi  toimintatapojen  muutosta  
5. Käyte:ävä  määri:elykieli   •  Määri4elymääri4elyt:  API  Blueprint,  Raml  ja  Swagger   •  Swagger  yleisin   •  työkalut  eivät  hirveän  kypsiä   •  Kilpailevilla  ehkä  paremmat,  mu4a  tunne4uus  ratkaisi   •  Swaggerin  ilmaisten  työkalujen  kanssa  on  selvi4y   •  Swagger  on  nyt  OpenAPI  määri4ely  ja  konsorIon  alla  
6. Swagger  työkalut   •  LähdeUin  ilmaisilla  liikkeelle,  itse  määri4elyn   kirjoi4aminen  ei  vaadi  paljoa   •  Petstore  eli  Swagger-­‐UI   •  Sangen  siisI  käy4ölii4ymä  Swagger-­‐dokumentoidun   rajapinnan  kokeiluun   •  Swagger  editor   •  Yhdiste4y  editori  ja  kokeilutyökalu  
7. Swagger  työkalut   •  LähdeUin  ilmaisilla  liikkeelle,  itse  määri4elyn   kirjoi4aminen  ei  vaadi  paljoa   •  Petstore  eli  Swagger-­‐UI   •  Sangen  siisI  käy4ölii4ymä  Swagger-­‐dokumentoidun   rajapinnan  kokeiluun   •  Swagger  editor   •  Yhdiste4y  editori  ja  kokeilutyökalu  
8. Käytännössä   •  Linkedevents  mallina,  on  jo  toiminnassa   •  Petstore   •  Swagger  editor  
9. Muita  työkaluja   •  Tähän  mennessä  on  tava4u  ainoastaan  IBM   •  Heidän  työkalunsa  on  Swaggerin  osalta  hieman   vaiheessa   •  Hyvin  pian  tutkitaan  myös  työkaluja,  joilla  voi  tehdä   tesIkehikon  Swagger-­‐määrityksestä  ja  testata  sillä   onko  rajapinta  määrityksen  mukainen    
10. Editori  
12. SE  OLI  SIINÄ