Jos käytät PTV:n tietoja käyttäjille näkyvässä palvelussa, esimerkiksi verkkosivuilla, suosittelemme välivarastoimaan tiedot omaan järjestelmääsi. Välivarastointi parantaa palvelun toimintavarmuutta ja vähentää riippuvuutta reaaliaikaisista rajapintakutsuista.
Päivitä välivarastoidut tiedot säännöllisesti, esimerkiksi kerran vuorokaudessa, hakemalla vain muuttuneet tiedot.
Ohjeita hakurajapinnan käyttöön
Tutustu hakurajapinnan kutsuihin ja niiden käyttöohjeisiin ympäristökohtaisessa rajapintadokumentaatiossa:
Hae PTV:stä edellisen haun jälkeen muuttuneet tiedot.
Voit hakea
julkaistun sisällön, jota on muutettu määritettynä ajankohtana tai sen jälkeen. Käytä publishedAtOrAfter-parametria, esimerkiksi 2024-03-20T13:45:30Z.
arkistoidun sisällön, joka on arkistoitu määritettynä ajankohtana tai sen jälkeen. Käytä archivedAtOrAfter-parametria.
Seuraavassa esimerkissä haetaan muuttuneet organisaatiotiedot. Voit hakea samalla tavalla muuttuneet palvelut, asiointikanavat, palvelukokonaisuudet ja pohjakuvaukset.
Saat liitostietojen ajantasaisen tilanteen hakemalla kaikki liitostiedot search-rajapintakutsulla. Voit hakea myös uudet ja päivitetyt liitostiedot publishedAtOrAfter-parametrilla samalla tavalla kuin organisaatioesimerkissä.
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 palvelupaikalle on saatavilla esteettömyystietoja, PTV:n hakurajapinta palauttaa niiden hakemiseen tarvittavan tunnisteen accessibilityRegisterServicePointId-kentässä..
