Mikä on RSS-Syöte
RSS (Really Simple Syndication) on web-syötemuoto, jota käytetään säännöllisesti päivitettävän sisällön julkaisemiseen standardisoidussa, koneluettavassa muodossa.
Lupapisteen Julkipano/Kuulutukset RSS-syötteen käyttö
Julkipano/Kuulutus palvelu vaatii aktivoinnin. Ota yhteyttä Lupapiste-asiakaspalveluun ([email protected]) toiminnon käyttöönottamiseksi.
Lupapisteen RSS-syöte päivittyy useita kertoja tunnissa. Uusimmat julkaistut julkipanot/kuulutukset eivät välttämättä näy syötteessä välittömästi.
Julkipanon/Kuulutuksen julkaiseminen riippuu siitä, miten se on määritetty päätöksellä julkaistavaksi. Esimerkiksi jos on määritetty, että kuulutus tehdään seuraavana päivänä päätöksen tekemisestä, kuulutus lisätään kuulutuspalvelun sivulle keskiyöllä vuorokauden vaihduttua ja se näkyy myös hetken kuluttua RSS-syötteellä.
RSS-syötteen löytäminen
RSS-syöte löytyy kunnan kuulutussivustolta:
- Etsi sivulta RSS-syötteen linkkiä (oranssi kuvakke taulukon oikeassa yläkulmassa)
Paina RSS painiketta avataksesi RSS-syötettä
- Kopioi selaimessa oleva URL-osoite
Syötteen tekninen tarkastelu ja oma toteutus
Kun avaat RSS-syötteen selaimessa, näet XML-muotoisen raakadatan:
- Kaikki syötteen elementit ovat näkyvissä raakatekstin
- Sisältö on koneluettavassa XML-muodossa
Käyttäjän (esim. kunnan verkkosivuston) on itse käsiteltävä ja muotoiltava RSS-syötteen tiedot haluamakseen näkymäksi.
RSS-Syötteen esimerkkidata
<rss version="2.0"> <channel> <copyright>Cloudpermit Oy</copyright> <language>fi</language> <lastBuildDate>Tue, 11 Feb 2025 14:03:37 GMT</lastBuildDate> <link>https://www-qa.lupapiste.fi/rss/kuulutus?organization=049-R&lang=fi</link> <pubDate>Mon, 10 Feb 2025 12:53:40 GMT</pubDate> <title>Kunnan rakennusvalvonta - Kuulutukset</title> <description>Kunnan rakennusvalvonta - Kuulutukset</description> <item> <lupapiste:toimenpideteksti xmlns:lupapiste="https://www.lupapiste.fi/rss/extensions">Asuinpientalon rakentaminen (enintään kaksiasuntoinen erillispientalo)</lupapiste:toimenpideteksti> <lupapiste:lupatunnus xmlns:lupapiste="https://www.lupapiste.fi/rss/extensions">LP-049-2025-90017</lupapiste:lupatunnus> <lupapiste:rakennuspaikka xmlns:lupapiste="https://www.lupapiste.fi/rss/extensions">Miniatontie 12</lupapiste:rakennuspaikka> <lupapiste:julkaisuAlkaa xmlns:lupapiste="https://www.lupapiste.fi/rss/extensions">Mon, 10 Feb 2025 22:00:00 GMT</lupapiste:julkaisuAlkaa> <lupapiste:julkaisuPaattyy xmlns:lupapiste="https://www.lupapiste.fi/rss/extensions">Wed, 19 Mar 2025 22:00:00 GMT</lupapiste:julkaisuPaattyy> <lupapiste:kiinteistotunnus xmlns:lupapiste="https://www.lupapiste.fi/rss/extensions">04903300810006</lupapiste:kiinteistotunnus> <lupapiste:paatosPvm xmlns:lupapiste="https://www.lupapiste.fi/rss/extensions">Sun, 9 Feb 2025 22:00:00 GMT</lupapiste:paatosPvm> <lupapiste:paatoksenPykala xmlns:lupapiste="https://www.lupapiste.fi/rss/extensions">5</lupapiste:paatoksenPykala> <lupapiste:paattaja xmlns:lupapiste="https://www.lupapiste.fi/rss/extensions">Rakennustarkastaja</lupapiste:paattaja> <lupapiste:asiakirjaLink xmlns:lupapiste="https://www.lupapiste.fi/rss/extensions">https://www-qa.lupapiste.fi/api/raw/download-bulletin-doc?bulletinId=LP-049-2025-90017_67a9f8ce2da1877d1f5ca3a0</lupapiste:asiakirjaLink> <description>"Toimenpideteksti julkipanoon" tähän</description> <guid isPermaLink="false">LP-049-2025-90017_67a9f8ce2da1877d1f5ca3a0</guid> <link>https://www-qa.lupapiste.fi/app/fi/local-bulletins?organization=049-R#!/r-bulletin/LP-049-2025-90017_67a9f8ce2da1877d1f5ca3a0</link> <title>Asuinpientalon rakentaminen (enintään kaksiasuntoinen erillispientalo)</title> </item> </channel> </rss> |
RSS-syötteen tekniset peruskomponentit
1. XML-rakenne
RSS-syöte on XML-dokumentti (eXtensible Markup Language), jolla on tietty rakenne. Jokainen syöte koostuu kanavasta <channel> elementti, joka sisältää useita kohteita <item>, jotka edustavat yksittäisiä sisältöelementtejä.
<?xml version="1.0" encoding="UTF-8" ?> <rss version="2.0"> <channel> <title>Kanavan otsikko</title> <link>Verkkosivuston URL</link> <description>Kanavan kuvaus</description> <item> <!-- Yksittäiset kohteet --> </item> </channel> </rss> |
2. Vakio RSS-elementit
Kanavatason <channel> elementit
Elementti | Kuvaus |
|---|---|
| Syötteen/verkkosivuston nimi |
| Pääasiallinen verkkosivuston URL |
| Lyhyt kuvaus kanavan sisällöstä |
| Sisällön kieli (esim. fi) |
| Viimeisin julkaisupäivämäärä |
| Viimeisimmän päivityksen aikaleima |
| Yksittäinen kohde |
Kohdetason <item> elementit
Elementti | Kuvaus |
|---|---|
| Yksittäisen sisältökohteen otsikko |
| Suora URL koko sisältöön |
| Yhteenveto tai koko sisältö |
| Uniikki ID yhdeelle itemille |
| <pubDate> | Muokkaus/luontihetki |
3. Lupapiste-laajennuksen erityiselementit
Lupapisten RSS-laajennus sisältää seuraavat kohdetason <item> erikoiselementtejä
Elementti | Kuvaus |
|---|---|
| Hankkeen LP-tunnus |
| Hankkeen rakennuspaikan osoite |
| Julkipanossa/kuulutuksissa näkyvä toimenpideteksti |
| Julkaisun alkamispäivä |
| Julkaisun päättymispäivä |
| Linkki kuulutettavaan asiakirjaan |
| Linkki päätöstietoihin |
| Kiinteistötunnus |
| Päivä, jolloin päätös on annettu |
| Päätöksen pykälä |
| Päättäjän nimeke |
| Luvan päätoimenpide |
Lupapisteen RSS skeema: https://www.lupapiste.fi/rss/extensions