- X-tee teenuste kasutamiseks peab olema X-tee liige ja üles seatud turvaserver.
- Avalikud teenused on toodud välja kõikide teenuste juures, mille kasutamiseks ei pea taotlema ligipääsu, vaid piisab, kui Teie asutus on liitunud X-tee EE keskkonnaga.
- Avalike teenuste kasutamise puhul nõustute MTP andmeteenuste kasutustingimustega
- Enamus maatoimingute platvormi X-tee teenustest on piiratud ligipääsuga, mille kasutamiseks peab taotlema ligipääsu.
- Kui teenus ei ole avalik, siis tuleb täita järgnev taotlus ning saata digiallkirjastatuna aadressile [email protected]
- Allalaadimiste puhul võivad muutuda linkide asukohad või struktuur, kui soovite saada teadet muudatuste kohta, siis palun täitke allolev vorm:
Maatoimingute platvormi X-tee ja API teenused
Tähelepanu! Anname teada, et seoses uue katastri süsteemi arendamisega on muutunud maakatastri X-tee teenused. Katastriteenustel lõppes andmete uuenemine ja need asendati uue MTP-Kataster alamsüsteemi teenustega. Andmete uuenemine vanades teenustes lõppes 29. märtsil 2024.
MTP-Kataster alamsüsteem (X-tee ja API)
Uued teenused cadastral-data ja cadasteCode on arendatud X-tee REST protokollis ning on saadaval üle X-tee või otse API kaudu. Nendele teenustele WSDL ei esitata, vaid on olemas OpenAPI spetsifikatsioonid dev, test ja live keskkondades:
https://x-tee.ee/catalogue/EE/GOV/70003098/mtp-kataster
Teenused /cadastral-data ja /valid on kõigile X-tee'ga liitunud alamsüsteemidel dev, test ja live keskkondades avatud. Allpool on toodud teenuste spetsifikatsioonid, milles on saadaval näidispäringu struktuur. Kui vajate abi päringu koostamisega, siis võtke ühendust [email protected].
Kui võtate kasutusele katastri API teenused ning teete igapäevaselt suurel hulgal päringuid, siis palume endast teada anda kirjutades [email protected].
Lisaks saab lugeda X-tee REST protokolli ja täiendavate spetsifikatsioonide kohta siit: https://blog.ria.ee/x-road-rest-tugi/
Teenused:
/xroad/cadastral-data
Teenus tagastab katastriüksuste muudatuse logi, asendab MIS-i teenust kylogi/v1.
Teenuste spetsifikatsioon (sisaldab näidispäringut, andmeväljade selgitusi, päringu sisendi parameetreid jne) -
Toimingute vastavused -
X-tee näidispäring LIVE keskkonnas (POST):
-- asendada enda asutusega seotud infoga --
curl --insecure \
--cert "-- turvaserveri kliendi alamsüsteemi sertifikaat --" \
--key "-- turvaserveri kliendi alamsüsteemi privaatvõti --" \
--location "https://--asutuse turvaserveri aadress--/EE/GOV/70003098/mtp-kataster/xroadservices/xroad/cadastral-data" \
--header "Content-Type: application/json" \
--header "Accept: */*" \
--header "X-Road-Client: --asutuse alamsüsteem formaadis „keskkond/liikmeklass/registrikood/alamsüsteem-- " \
--header "X-Road-Id: --x-tee päringu unikaalne identifikaator nt UUID formaadis-- " \
--data '{"id" : "-1"}'
API näidispäring LIVE keskkonnas (POST):
curl -X 'POST' \
'https://cadastrepublic.kataster.ee/api/xroad/cadastral-data' \
-H 'accept: */*' \
-H 'Content-Type: application/json' \
-d '{
"id": -1,
"algkuupaev": "2024-04-11T07:34:02.508Z",
"loppkuupaev": "2024-04-11T07:34:02.508Z",
"ay_kood": "string",
"ov_kood": "string",
"mk_kood": "string",
"tunnus": "string",
"mis_muutused": "string"
}'
/xroad/valid{cadastreCode}
Teenuse asendab MIS alamsüsteemi teenust kytunnus.v1. Tegemist on GET päringuga. Teenus võimaldab pärida katastriüksuse tunnuse põhjal infot antud üksuse kohta.
Teenuste spetsifikatsioon (sisaldab näidispäringut, andmeväljade selgitusi, päringu sisendi parameetreid jne) -
X-tee näidispäring LIVE keskkonnas (GET):
-- asendada enda asutusega seotud infoga --
curl --insecure \
--cert "-- turvaserveri kliendi alamsüsteemi sertifikaat --" \
--key "-- turvaserveri kliendi alamsüsteemi privaatvõti --" \
--location "https://--asutuse turvaserveri aadress--/EE/GOV/70003098/mtp-kataster/xroadservices/xroad/valid /79501%3A027%3A0011" \ --katastriüksuse tunnus määrata teenuse parameetrina--
--header "Content-Type: application/json" \
--header "Accept: */*" \
--header "X-Road-Client: --asutuse alamsüsteem formaadis „keskkond/liikmeklass/registrikood/alamsüsteem-- " \
--header "X-Road-Id: --x-tee päringu unikaalne identifikaator nt UUID formaadis-- " \
API näidispäring LIVE keskkonnas (GET):
CURL:
curl -X 'GET' \
'https://cadastrepublic.kataster.ee/api/xroad/valid/79501%3A027%3A0011' \
-H 'accept: */*'
URL: https://cadastrepublic.kataster.ee/api/xroad/valid/79501%3A027%3A0011
MIS alamsüsteem (X-tee)
MIS X-tee teenusega on võimalik pärida andmeid katastriüksuste, kõlvikute, EHAK jm andmekogude kohta. MIS on registreeritud ka RIHA-s ja teenused (WSDL) on kirjeldatud X-tee kataloogis.
Kehtivad MIS X-tee teenused:
- ehakkehtiv/v1 → avalik teenus
- ehaklogi/v1 → avalik teenus
- ehaklogikompl/v1 → avalik teenus (NB! Teenus lõpetatakse 5. juuni 2026 ja ei asendu)
- tehingud/v2
MIS X-tee teenused, milles on lõppenud andmete uuenemine (seisuga 29. märts 2024):
- kyasukoht/v1 → ei asendu
- kykolvik/v1 → Cadastre-unit/find
- kylogi/v1 → Cadastral-data
- kylogiManus/v1 → ei asendu
- kytunnus/v1 → Cadastre-code
- maksustamishinnaAndmed/v1 → Mkhis-detailed
MIS X-tee teenused, mis ei ole enam kasutuses (vt. KPOIS alamsüsteem teenuseid):
- isikuKitsendused/v1
- juromandiKitsendused/v1
- kpo_lk_mk_logi/v1
- kyKitsendused/v1
- omanikuKitsendused/v1
- paigaldis_logi/v1
- paigaldis_probleem/v1
MAAOK alamsüsteem (X-tee)
MAAOK X-tee teenusega on võimalik oksjoneid lisada, muuta, kustutada ja otsida. MAAOK on registreeritud ka RIHA-s ja teenused (WSDL) on kirjeldatud ka X-tee kataloogis.
MAAOK X-tee teenused:
- klassifikaatorid/v1
- oksjoniLisamine/v1
- oksjoniMuutmine/v1
- oksjoniObjektiKatkestamine/v1
- oksjoniObjektiOtsing/v1
- maaok/rkSendMessageIso/v1
KPOIS alamsüsteem (X-tee)
Kitsenduste X-tee teenus võimaldab pärida kitsendusi põhjustavaid objekte, kitsenduste mõjualasid, kitsendusi kustutada, lisada, muuta, pärida kitsendusekaardi linki või trükist ning maamaksu soodustuse vööndi suurust. KPOIS on registreeritud ka RIHA-s ja teenused (WSDL) on kirjeldatud ka X-tee kataloogis.
KPOIS X-tee teenused:
- kyKitsendused/v2
- kyKitsendusedAvalik/v2
- kpois/kyKitsendusedKustutamine/v1
- kyKitsendusedLisamineMuutmine/v1
- kyKitsendusteLink/v1
- kyKitsendusteTrykis/v2
- kyMaamaksuSoodustused/v1
- kyKpo/v2
NB! kyKitsendusedAvalik ei tagasta I ja II kaitsekategooria objekte, kyKitsendused tagastab.
Tiheasustusalad alamsüsteem (X-tee)
Tiheasustusalade X-tee teenus võimaldab pärida tiheasustusala olemasolu etteantud katastriüksuses või ruumikujus ja ka tiheasustusalade raportit. Teenused (WSDL) on kirjeldatud ka X-tee kataloogis. Spetsifikatsioon on koostamisel.
Tiheasustusalade X-tee teenused:
- loeTiheasustusAladeRaport/v1
- tiheasustusAla/v1
- tiheasustusAladeRaport/v1
Kõlvikute API teenus
Kõlvikute rakenduses on välja arendatud API teenused, mille kaudu saab pärida kõlvikulist koosseisu nii katastriüksuse kui ka geomeetria järgi. NB! Kõlvikute rakendus ei paku 2024. aastast vanemaid andmeid.
Teenused:
GET /api/cadastre-unit/find
Teenusest saab leida kuupäeva ja tunnuse abil infot katastriüksuse ja selle kõlvikulise koosseisu kohta.
Päringu otspunkt ja parameetrid:
https://kolvikud.kataster.ee/api/cadastre-unit/find?date={kuupaev}&code={tunnus}
{kuupaev} täitmiseks tuleb sisestada kuupäev järgmises formaadis yyyy-mm-dd (aasta-kuu-päev). NB! Kõlvikute rakendus ei paku 2024. aastast vanemaid andmeid.
{tunnus} kohale läheb katastriüksuse tunnus.
Näidispäring:
https://kolvikud.kataster.ee/api/cadastre-unit/find?date=2024-02-01&code=79501:027:0011
POST /api/land-parcel/by-geometry
Teenuse kaudu on võimalik pärida kuupäeva ja WKT geomeetria abil infot kõlvikulise koosseisu kohta.
Päringu otspunkt ja parameetrid:
https://kolvikud.kataster.ee/api/land-parcel/by-geometry
{date} - kuupäev formaadis yyyy-mm-dd (aasta-kuu-päev).
{geometry} - geomeetria WKT formaadis
Näidispäring:
{
"date": "2024-03-22",
"geometry": "POLYGON ((658365.01 6474203.05, 658351.19 6474183.33, 658340.38 6474178.66, 658323.9 6474171.84, 658325.94 6474166.93, 658332.47 6474150.69, 658343.71 6474155.17, 658349.3 6474157.38, 658363.33 6474162.94, 658371.32 6474162.07, 658382.63 6474166.35, 658371.34 6474191.77, 658365.01 6474203.05))"
}
curl -X POST "https://kolvikud.kataster.ee/api/land-parcel/by-geometry"
-H "accept: application/json"
-H "Content-Type: application/json"
-d "{\"date\":\"2024-03-22\",\"geometry\":\"POLYGON ((658365.01 6474203.05, 658351.19 6474183.33, 658340.38 6474178.66, 658323.9 6474171.84, 658325.94 6474166.93, 658332.47 6474150.69, 658343.71 6474155.17, 658349.3 6474157.38, 658363.33 6474162.94, 658371.32 6474162.07, 658382.63 6474166.35, 658371.34 6474191.77, 658365.01 6474203.05))\"}"
Maa korralise hindamise infosüsteemi (MKHIS) API teenused
Maa korralise hindamise API teenuste kaudu on võimalik pärida katastriüksuste kohta kehtivat maksustamishinda ehk maa väärtust.
Teenused:
POST /api/x-road/mkhis-log
Teenusest saab ISO formaadis oleva kuupäeva ja kellaaja alusel pärida kõik sellest hetkest uue maksustamishinna saanud katastritunnused.
Päringu otspunkt:
https://hindamine.kataster.ee/api/x-road/mkhis-log
Näide:
2024-02-27T11:32:27.6176079+02:00
POST /api/x-road/mkhis-detailed
Teenuse kaudu on võimalik pärida andmeid maatüki tunnuse või maatüki tunnuse ja kuupäeva põhjal. Kui sisendiks on ainult tunnus, tagastatakse hetkel kehtiv väärtus. Kui sisendiks anti ka kuupäev, tagastab teenus maa väärtuse selle kuupäeva seisuga.
Päringu otspunkt:
https://hindamine.kataster.ee/api/x-road/mkhis-detailed
Näide:
{
"cadastreId": "79501:027:0011",
"validDate": "2024-02-29"
}
POST /api/x-road/mkhis-detailed-by-batch
Teenuse kaudu on võimalik pärida hetkel kehtivaid maksustamishindu katastritunnusete alusel. Teenus võimaldab küsida tulemusi kuni 1000 kaupa korraga.
Päringu otspunkt:
https://hindamine.kataster.ee/api/x-road/mkhis-detailed-by-batch
Näide:
[
"79501:027:0011",
"78407:701:6840"
]
EHAK andmevahetusteenused (REST API/X-tee)
MIS alamsüsteemi EHAK andmevahetusteenused võimaldavad pärida haldus- ja asustusüksuste kehtivat seisu ja muudatusi. Seoses e-Katastri, sh vana EHAK menetlussüsteemi sulgemisega, lõpeb allolevates X-tee teenustes andmete uuenemine alates 5. juuni 2026. Teenused asenduvad uute REST API ja X-tee teenustega. Uus spetsifikatsioon on koostamisel ja X-tee teenused (WSDL) kirjeldatakse ka X-tee kataloogis MIS alamsüsteemi teenuste lehel. Tarbijaid teavitatakse uute teenuste avaldamisest.
Kehtivad EHAK X-tee teenused:
- ehakkehtiv/v1
- ehaklogi/v1
- ehaklogikompl/v1 (NB! Teenus lõpetatakse 5. juuni 2026 ja ei asendu)
Viimati uuendatud 04.03.2026
