Palvelutietovarannon häiriöt ovat harvinaisia. Tästä huolimatta suosittelemme käyttämään tiedon välivarastointia, jos PTV:n tietoja käytetään osana käyttäjille näkyvää palvelua, esimerkiksi verkkosivuilla.
Tiedon välivarastointi omaan järjestelmään parantaa integraation toimintavarmuutta ja vähentää riippuvuutta reaaliaikaisista rajapintakutsuista. Tiedot voidaan päivittää säännöllisesti PTV:stä, esimerkiksi kerran vuorokaudessa, hakemalla vain muuttuneet tiedot.
Ohjeita hakurajapinnan käyttöön
Rajapintakutsut ja niiden käyttöohjeet löydät ympäristökohtaisesti:
PTV:n rajapintakutsuilla on mahdollista hakea sisältöjä, joille on tehty muutoksia edellisen haun jälkeen.
Voit hakea
julkaistua sisältöä, johon on tehty muutoksia annettuna ajanhetkenä tai sen jälkeen käyttämällä parametria publishedAtOrAfter (esim. 2024-03-20T13:45:30Z).
poistettua eli arkistoitua sisältöä, joka on arkistoitu annettuna ajanhetkenä tai sen jälkeen (parametri archivedAtOrAfter).
Alla on kuvattu muuttuneiden tietojen hakeminen, esimerkkinä organisaatiotiedot. PTV:n muuttuneet palvelut, asiointikanavat, palvelukokonaisuudet ja pohjakuvaukset haetaan vastaavalla tavalla.
Liitos-tietojen ajantasainen tilanne saadaan hakemalla kaikki liitostiedot search –rajapintakutsulla. Voit myös hakea uudet ja päivitetyt liitostiedot, kuten yllä olevassa organisaatio-esimerkissä käyttämällä parametria publishedAtOrAfter.
Organisaatiotiedot
1. Hae uudet ja päivitetyt organisaatiot
GET /api/v12/organization/search?page=1&pageSize=100&publishedAtOrAfter=2026-03-31T12%253A29%253A51.540Z
page=1 kertoo monettako sivua haet, pageSize=100 kertoo montako tulosta yhdelle sivulle palautetaan ja PublishedAtOrAfter sisältää hakua rajaavan ajanhetken
Saat vastauksena organisaatioiden tiedot (items-taulukko).
Toista niin kauan kuin rajapinta palauttaa hakutuloksia (items-taulukko ei ole tyhjä).
Lisää uudet organisaatiot omaan tietokantaasi ja päivitä muuttuneiden organisaatioiden tiedot.
2. Hae arkistoidut organisaatiot
GET api/v12/organization/archived?page=1&pageSize=100&archivedAtOrAfter=2026-01-30T12%3A29%3A51.540Z
Saat vastauksena organisaatioiden content-id-listauksen.
Jos PTV:ssä kuvatulle palvelupaikalle on saatavilla esteettömyystiedot, PTV:n hakurajapinta palauttaa tunnistetiedon esteettömyystietojen hakemiseen kentässä accessibilityRegisterServicePointId.
