Huom! Alla kuvatun Espoo.fi -verkkopalvelun vanhat rajapinnat poistuivat käytöstä 1.9.2021 verkkosivuston siirryttyä uudelle teknologia-alustalle. Espoon tapahtumia voi hakea Espoon tapahtumarajapinnan kautta. Rajapinta uuden sivuston uutisten hakuun tullaan dokumentoimaan vuoden 2022 aikana. Pahoittelumme näistä muutoksista mahdollisesti aiheutuvasta vaivasta.
Espoon kaupungin julkaisujärjestelmään toteutetun avoimen rest-rajapinnan kautta voi hakea Espoo.fi-sivustolta uutisia, tapahtumia, hankkeita, sähköisiä palveluita, kuulutuksia ja perussisältödokumentteja.
Rajapinta noudattaa oData-määritystä. Dataa voi hakea espoo.fi-sivuilta joko koko sivustosta, tietystä navigointitasosta tai jollain sivuston luokittelulla. Rajapinta kattaa kaikki kolme espoo.fi-sivuston kieliversiota (suomi, ruotsi, englanti). Hakua voidaan rajoittaa sisältötyypillä.
Rajapintojen antama data on oletuksena Atom-formatoitua xml:ää. Datan saa ulos myös JSON- (parametrilla $format=json) ja JSONP-muodoissa (parametrilla $callback=funktionnimi). Aineiston merkistö on utf-8.
Rajapinta palauttaa sisältöjen perustiedot. Kaikille erityyppisille sisällöille palautetaan aina samat tiedot. Tapahtumalle löytyy kuitenkin arvot tietoihin EventStartDate ja EventEndDate, jotka muilla sisältötyypeillä ovat aina tyhjät.