REST X-tee teenused

Pidevalt täienevad arendus- ja testkeskkonna teenuste kirjeldused on leitavad X-tee teenuste kataloogist.

Isiku andmete teenus

Teenus, mis tulevikus asendab kõiki seniseid rahvastikuregistri X-tee teenuseid, mille sisendiks on isikukood või isikukoodid.
Teenus on seadistatav tagastama andmeid nii pärijale vajalike andmeväljade lõikes kui ka näiteks lubatud dokumentide, aadresside, suhte liikide jms suhtes.

Isikute muudatuse teenus

Teenus, mis tulevikus asendab kõiki seniseid rahvastikuregistri X-tee teenused, mis tagastavad pärijale isikutega teatud perioodil toimunud muudatusi.

Teenus on seadistatav tagastama andmeid pärijale vajalike muudatuste lõikes. Uuendusena on (vajaduse ja õiguse põhiselt) võimalik saada ka loend muudatustest, mis isikuga on toimunud.

Olulisemad kuupäevad isikute andmete ja isikute muudatuste teenustele üleminekul:

• 19.02.2025 kell 11:00 – Infotund rahvastikuregistri X-tee teenuste kasutajatele.
• 05.03.2025 kell 13:00 – Infotund rahvastikuregistri X-tee teenuste kasutajatele, tehnilised küsimused.
• 31.03.2025 – Teenused on testitavad DEV ja TEST keskkonnas. NB! Teenuste testimise soovist tuleb teada anda aadressile ....
• 31.08.2025 – Teenused on toodangus ja kasutusele võetavad. NB! Teenuste toodangukeskkonnas kasutuselevõtuks tuleb lähtuda seniste ja uute teenuste omavahelisest vastavusest ning esitada juurdepääsutaotlus Siseministeeriumi juurdepääsude menetlemise infosüsteemis aadressil https://rr-taotlus.smit.ee.

Dubleerivate, sama funktsionaalsust võimaldavate, teenuste töös hoidmine on väga kulukas, mistõttu plaanitakse need teenused, mida asendavad isiku andmete ja isikute muudatuste teenus, sulgeda 2026. aasta lõpuks. Detailsem ajaplaan avalikustatakse esimesel võimalusel.

Mõned põhimõtted, millest lähtume:

• liigume teenusepõhiselt, vähemkasutatavad teenused enne;
• asutustele/ettevõtetele, millel on mitu teenust paralleelselt kasutusel, lähenetakse eraldi.

Uutele X-tee teenustele üleminek tähendab ka seni kehtivate juurdepääsuotsuste muutmist selliselt, et juurdepääsud vastaksid uutele X-tee teenustele ja nende reaalsetele kasutuseesmärkidele. Selles osas võtab Siseministeerium täiendavalt aegsasti kõigi teenuse kasutajatega ühendust.

Küsimustele vastab ....

Tegemist on teenustega, mis on visioonistaadiumis ja ajakava nende üleviimise kohta on valmimisel.

Isiku otsingu teenus

Teenus, mis tulevikus asendab kõiki seniseid rahvastikuregistri X-tee teenuseid, mis peavad tagastama mingite kriteeriumite alusel isikute loendi. Näiteks:

• perioodil sündinud või surnud isikud;
• mingil aadressil elavad isikud.

Teenuse valmimise aeg sõltub uue rahvastikuregistri menetlustarkvara valmimisest.

Kandeteenused

Teenused, millega kantakse rahvastikuregistrisse andmeid nagu näiteks:

• viibimiskoha teenus;
• lisa-aadresside ja kontaktide teenus;
• lahutuste kandmise teenus;
• sünni korral isikukoodide tellimine;
• surma kandmise teenus;
• jne.

Kust näeb suletavate teenuste nimekirja ja uute teenustega asendamise vastavustabelit? 

Tabel asub ülaltoodud kirjelduse teises lõigus.

Kas teenuseid saab kasutada MISPi kaudu?

REST teenuseid ei saa MISP kaudu kasutada. RIA teavituse kohaselt MISP2 suletakse 31.12.2025.

Milline hakkab olema uute teenuste maksumus?

Uute teenuste maksustamise mudel on välja töötamisel, aga tõenäoliselt Isiku info päringu puhul maksustatakse jätkuvalt küsitud/tagastatud isikute arvu. Kehtiv tasude määrus on kättesaadav SIIT: https://www.riigiteataja.ee/akt/112012021002

Avaliku ülesande täitmiseks väljastatakse andmed endiselt tasuta. Päringute eest peavad tasuma need kasutajad, kellel on juurdepääs õigustatud huvi alusel.

Kas nimetatud muudatused toovad asutustele kaasa ka muudatusi senistes juurdepääsudes ja nende dokumenteerimises?

Uutele X-tee teenustele üleminek annab võimaluse korrastada olemasolevad juurdepääsud, vaadata üle senised andmete kasutamise eesmärgid ning õiguslikud alused. Eesmärk on tagada igale kasutajale just talle vajalik andmekoosseis, mis vastab tema andmete kasutamise eesmärgile ja õiguslikule alusele ning ei toimuks liiasusega andmete töötlemist. Nii saame ühiselt tagada, et isikuandmete töötlemine toimub igati vastavuses isikuandmete töötlemisele kohalduvate nõuetega.

Kuivõrd seni on antud juurdepääs üldjuhul asutusele, kuid uued teenused avatakse alamsüsteemile, toob see kaasa ka seniste juurdepääsude ümbervormistamise. Uutele X-tee teenustele juurdepääsu saamiseks tuleb esitada taotlus rahvastikuregistri andmetele juurdepääsu menetlemise infosüsteemis (https://rr-taotlus.smit.ee/). Taotluse peavad esitama nii uued kasutajad kui ka need, kellel juba on varasemast juurdepääs antud.

Anname jooksvalt teada, kui on võimalik uutele teenustele juurdepääsu taotleda ning kuidas seda peaks tegema. Teeme endast kõik oleneva, et saaksime selleks anda teile võimalikult palju eelnevat teavet teenuste asendamise kohta ning vältida liigset asjaajamist.

Kas teenuste testimiseks on tarvis esitada taotlus läbi Juurdepääsu menetlemise infosüsteemi?

Ei, piisab kirjast aadressile ...

Kas uued teenused on seotud ka Andmejälgijaga?

Jah, nii nagu muud rahvastikuregistrisse tehtud päringud, kuvatakse ka need andmejälgija teenuses.

Kas teenuste kasutajatel on võimalik taotleda keskset raha teenuste arendamiseks?

Oleme uurinud keskse rahastuse võimalust MKM-st. Nende vastus on, et kahjuks selline võimalus täna puudub.

Kas teenuste tehniline kirjeldus on ka inglise keeles?

Ei ole. Tehniline kirjeldus on hõlpsasti tõlgitav mõne tõlkeprogrammi abil.

Kuidas kasutaja saab aru, kas andmeväli on talle keelatud või päritaval isikul see andmeühik puudub?

Isikute info teenusele lisatakse päisesse (masinloetav) infoväli, kuhu loetletakse väljad, mis on pärijale keelatud.

Kas Isikute info teenusega saab korraga pärida korraga ühe või mitme isiku kohta?

Hetkeseisuga ei ole veel kindlat otsust, aga kaldub selle poole, et saab pärida ühe isiku infot korraga.

Kas teenustele tekib lisaks OpenAPI dokumentatsioonile ka täiendav spetsifikatsioon?

Tänase seisuga ei teki. Täiendame ja parandame pidevalt OpenAPI dokumentatsiooni, sealhulgas lisame võimalikud väljade väärtused, kus see mõistlik on. OpenAPI dokumentatsiooni viimane versioon on alati saadaval X-tee kataloogist.

Kust saada infot võimalike RR-s kasutatavate andmekomplektide liikide ning staatuste kohta, kui on tarvis Isiku info päringut kuidagi filtreerida?

RR-s kasutatavad andmekomplektide liigid ning nende staatused on kirjeldatud kodifikaatoritena. Kodifikaatorite kohta saab infot X-tee teenusega Kodifikaator/Info. Selle, mille kohta täpselt küsida, kirjeldame teenuse OpenAPI dokumentatsioonis.

Kas uute teenustega kaasneb ka jõudluse kasv või langus?

Teenuste loomisel lähtume eesmärgist, et olulist jõudluse langust teenuse kasutamisega ei kaasne.

Kas uute teenustega säilib võimalus kasutada representedParty funktsionaalsust?

Jah, säilib.

Kas on olemas testisikud, kellega päringut proovida?

Isikukoodid, kellel on RR DEV ja TEST keskkondades keskmisest rohkem andmeid, on:

• 47507194712
• 47303144913
• 38211025218