SDGE Rest Specifikacija v1.2

REPUBLIKA HRVATSKA
DRŽAVNA GEODETSKA UPRAVA
SDGE REST API SPECIFIKACIJA
Ver. 1.2
Sadržaj
1 Uvod ......................................................................................................................................... 1
2 Kreiranje servisnog djelatnika .................................................................................................. 2
3 Popis REST servisa .................................................................................................................. 3
3.1 Dohvat autentifikacijskog tokena............................................................................. 3
3.2 Kontrola kvalitete ..................................................................................................... 3
3.3 Konverzija GML-a u DXF ....................................................................................... 5
3.4 Dohvat upisnika ....................................................................................................... 5
3.5 Kreiranje predmeta ................................................................................................... 6
3.6 Dohvat predmeta .................................................................................................... 10
3.6.1 Kompleksni tip predmeta............................................................................. 11
3.7 Kreiranje elaborata ................................................................................................. 11
3.8 Dohvat elaborata .................................................................................................... 12
3.8.1 Kompleksni tip elaborata ............................................................................. 13
3.8.2 Kompleksni tip svrha ................................................................................... 14
3.9 Evidencija zahtjeva za izdavanje podataka ............................................................ 14
3.10 Popis zahtjeva za izdavanje podataka u elaborate ................................................. 15
3.10.1 Kompleksni tip zahtjeva .............................................................................. 15
3.11 Uvoz GML-a .......................................................................................................... 16
3.12 Dohvat KT prijavnih listova .................................................................................. 17
3.12.1 Kompleksni tip KT prijavni list ................................................................... 17
3.13 Uvoz DXF datoteka ............................................................................................... 18
3.14 Dohvat RPJ naselja ................................................................................................ 18
3.15 Dohvat RPJ ulica .................................................................................................... 19
3.16 Dohvat RPJ katastarskih općina ............................................................................. 20
3.17 Auto-login .............................................................................................................. 20
4 Šifarnici .................................................................................................................................. 22
4.1 Status kontrole........................................................................................................ 22
4.2 Vrsta posla.............................................................................................................. 22
4.3 Metoda izrade ......................................................................................................... 22
4.4 Oznaka uklopa (Grafički dio) ................................................................................ 22
4.5 Pravila kontrole (van PNP) .................................................................................... 22
4.6 Vrsta plana (van PNP)............................................................................................ 23
4.7 Stanje podataka ...................................................................................................... 23
4.8 Vrsta stranke .......................................................................................................... 23
4.9 Potreba elaborata .................................................................................................... 23
4.10 Postupak održavanja DKP ..................................................................................... 23
4.11 Koordinatni sustav ................................................................................................. 23
4.12 ZK stanje ................................................................................................................ 24
4.13 Oznaka ovjere ........................................................................................................ 24
4.14 Oznaka provedbe.................................................................................................... 24
4.15 Status zahtjeva........................................................................................................ 24
4.16 Status promjene prijavnog lista .............................................................................. 24
4.17 ApiStatus ................................................................................................................ 24
4.18 Status GML uvoza ................................................................................................. 25
5 Servisi za šifarnike ................................................................................................................. 26
5.1 Dohvat šifarnika Djelatnost ................................................................................... 26
5.2 Dohvat šifarnika Posao .......................................................................................... 26
5.3 Dohvat šifarnika Svrha elaborata ........................................................................... 27
6 Vanjski šifarnici ..................................................................................................................... 28
1 Uvod
REST API je programsko sučelje aplikacije zasnovano na REST (Reprezentacijsko stanje

prijenosa) arhitekturi. Radi se o klijent – server arhitekturi pomoću koje razni sustavi mogu
jednostavno komunicirati putem HTTP protokola. REST API razmjenjuje podatke s drugim
sustavima putem JSON (JavaScript Object Notation) formata, uz propisanu specifikaciju za poziv
svake metode, te dodatnih parametara zaglavlja HTTP poruke.
REST API modul je sučelje preko kojeg ostali sustavi treće strane mogu upotrebljavati SDGE
funkcionalnosti. Putem poziva raznih metoda koje su izložene za pozive, vanjski sustavi mogu
voditi dio procesa izrade DGE unutar SDGE-a. Uz standardne korake izrade elaborata mogu se
izvršavati i popratni procesi kao kontrola kvalitete DKP-a i konverzija GML-a razmjenskog
formata u DXF format.
SDGE REST API je javno objavljen preko interneta, a pristupiti mu mogu vanjski sustavi koji će
se predstavljati servisnim računima korisnika SDGE-a. Drugim riječima svaki korisnik koji preko
vanjskog sustava radi sa SDGE-om mora imat svoj SDGE korisnički račun i njemu pridružen
'servisni korisnički račun'. Na taj način se osigurava da se cjelokupni rad korisnika putem REST
API-a može odmah po izvršavanju transakcije vidjeti u SDGE web aplikaciji i vezan je na
korisnika koji je odradio proces putem servisa. Servisni korisnički račun također služi kao dodatni
sigurnosni mehanizam da korisnici ne upisuju svoje pristupne podatke za SDGE u druge sustave.
Na temelju podataka vezanih na servisni korisnički račun (servisni ključ i lozinka) generira se
token s vremenskim trajanjem koji se dalje šalje kao parametar zaglavlja HTTP poruke. Token se
generira preko REST API osnovne autentikacije (eng. Basic authetication) gdje se servisno
korisničko ime i lozinka šalju kodirani kao base64 znakovni niz. Cijeli proces razmjene poruka
ide preko HTTPS protokola kako bi se osigurala enkripcija cijele poruke. Kako je omogućena
prijava u aplikaciju preko tako dobivenog tokena, ograničeno je vrijeme trajanja samog tokena.
Predviđeno trajanje vremenskog tokena za produkcijsko okruženje je nekoliko minuta. Nakon
isteka korisnik, tj. drugi sustav mora dohvatiti novi token prije korištenja sljedećeg REST servisa.
Za metode uvoza i konverzije podataka potrebno je prenošenje cijelih datoteka. Zbog

poboljšavanja performansi sve datoteke koje se razmjenjuju između sustava se prenose unutar ZIP
datoteke. ZIP datoteke se kodiraju u base64 znakovni niz i šalju se kao parametri poruka zahtjeva
i odgovora. Tako će se pri uvozu prijedloga novog stanja u prijavni list datoteka skice izmjene
smjestiti u ZIP datoteku koja se zatim dodaje kao parametar „datoteka“.
1
2 Kreiranje servisnog djelatnika
Za pristup korištenju SDGE-u potrebno je za postojećeg korisnika kreirati autentikacijski ključ i

lozinku koja se koristi za prijavu na servise.
Klikom na logiranog korisnika dolazi se do sučelja gdje se upisuju podaci za servisni pristup.
Korisnik generira jedinstveni ključ i upisuje proizvoljnu lozinku (može biti jednaka kao i ona za
login u sustav).
Nakon što korisnik upiše podatke potrebno je upisati podatke i u sustav koji poziva Rest API
SDGE-a.
Prilikom pozivanja Rest API-a korisnik prvo poziva servis za dohvat tokena s vremenskim
trajanjem koji se kasnije šalje u header-u http zahtjeva.
Prilikom korištenja SDGE rest servisa potrebno je u prvom koraku pozvati autentifikacijski servis
s točnim autentifikacijskim tokenom i servisnom lozinkom koji će generirati autentifikacijski
token s vremenskim rokom trajanja.
• Testno (pred-produkcijsko) okruženje: https://sdge-test.dgu.hr/services/rest
• Produkcijsko okruženje: https://sdge.dgu.hr/services/rest
2
3 Popis REST servisa
3.1 Dohvat autentifikacijskog tokena
Url: /authentication/createToken
Metoda: Post
Parametar zaglavlja Vrijednost

Authorization Servisni ključ; Lozinka (base64)
Content-Type application/json
Parametar Tip Obavezno Vrsta

token STRING DA OUT
apiStatus INTEGER DA OUT
Koristi se „Basic autentikacija“ kojom se šalje autentifikacijski token i lozinka enkodirani u

base64 stringu.
Servis vraća token s vremenskim rokom trajanja od 1h za test, produkcijski timeout je 5 min.
3.2 Kontrola kvalitete

Url: /quality/kontrola-kvalitete
Metoda: Post
Primjer:
{
"katastarskaOpcinaMbr": 301019,
"nazivKontrole": "wwwwww",
"vrstaPosla":2,
"metodaIzrade":1,
"pravilaKontrole": 1,
"vrstaPlana": 1,
"stanje": 1,
"pravilaKontroleIzvanPNP":1,
"vrstaPlanaIzvanPNP":1,
"grafickiDio":0,
"datoteka": "Base64 zip"
}
3
Authorization Token

katastarskaOpcinaMbr INTEGER DA IN
nazivKontrole STRING DA IN
vrstaPosla INTEGER DA IN
metodaIzrade INTEGER NE (ovisi o vrsti IN
posla)
pravilaKontrole INTEGER DA IN
vrstaPlana INTEGER DA IN
stanje INTEGER DA IN
pravilaKontroleIzvanPNP INTEGER NE (ovisi o stanju IN
podataka)
vrstaPlanaIzvanPNP INTEGER NE (ovisi o stanju IN
podataka)
grafickiDio INTEGER NE (ovisi o vrsti IN
posla)
datoteka* BINARY DA IN
greske* BINARY DA OUT
status INTEGER DA OUT
*
Datoteke se razmijenjuju u .zip formatu
4
3.3 Konverzija GML-a u DXF
url: /konverzija
Metoda: Post
Primjer:
{
"svrha": "Test",
"primjedba": "Test",
"datoteka": "Base64 zip OSS izvoza"
}

Authorization Token

svrha STRING DA IN
primjedba STRING NE IN
datoteka STRING DA IN
status* INTEGER DA OUT
datoteka* STRING DA OUT
3.4 Dohvat upisnika
Url: /upisnik/getPopisUpisnika
Metoda: Post
Primjer:
{
"godina": 2018
}

Authorization Token
5
godina INTEGER DA IN
upisnikId INTEGER DA OUT
3.5 Kreiranje predmeta
Url: /upisnik/savePredmet
Metoda: Post
Primjer:
{
"upisnikId": 179,
"rbrPredmeta": null,
"datumOsnivanjaPredmeta": "2018-03-16",
"djelatnostId": 25,
"posaoId": 47,
"nazivPredmeta": "asd",
"datumUgovaranjaPosla": "2018-03-15",
"ugovorenaCijena": 300.50,
"katastarskaOpcinaMbr": 301019,
"naseljeMbr": 11584,
"lokacija": "ASD",
"brojPlana": "123",
"oznakaOvjere": 0,
"oznakaProvedbe": 0,
"primjedba": "123",
"vrstaStranke": 0,
"oibStranke": null,
"imeStranke": "Pero",
"prezimeStranke": "Perić",
"nazivStranke": null,
"naseljeStrankeMbr": "027898",
"naseljeStrankeNaziv": null,
"ulicaStrankeRbr": "58",
"ulicaStrankeNaziv": null,
"kucniBrojStranke": "10",
"kucniPodbrojNStranke": null,
"kucniPodbrojAStranke": null,
"isoKodDrzaveStranke": null,
"brojPosteStranke": "51215",
"nazivPosteStranke": "Kastav",
"kontaktPodaciStranke": null,
6
"vrstaNarucitelja": 0,
"oibNarucitelja": null,
"imeNarucitelja": "Pero",
"prezimeNarucitelja": "Perić",
"nazivNarucitelja": null,
"naseljeNaruciteljaMbr": "027898",
"naseljeNaruciteljaNaziv": null,
"ulicaNaruciteljaRbr": "58",
"ulicaNaruciteljaNaziv": null,
"kucniBrojNarucitelja": "10",
"kucniPodbrojNNarucitelja": null,
"kucniPodbrojANarucitelja": null,
"isoKodDrzaveNarucitelja": null,
"brojPosteNarucitelja": "51215",
"nazivPosteNarucitelja": "Kastav",
"kontaktPodaciNarucitelja": null,
"vrstaInvestitora": 0,
"oibInvestitora": null,
"imeInvestitora": "Pero",
"prezimeInvestitora": "Perić",
"nazivInvestitora": null,
"naseljeInvestitoraMbr": "027898",
"naseljeInvestitoraNaziv": null,
"ulicaInvestitoraRbr": "58",
"ulicaInvestitoraNaziv": null,
"kucniBrojInvestitora": "10",
"kucniPodbrojNInvestitora": null,
"kucniPodbrojAInvestitora": null,
"isoKodDrzaveInvestitora": null,
"brojPosteInvestitora": "51215",
"nazivPosteInvestitora": "Kastav",
"kontaktPodaciInvestitora": null,
"ktCestice": [],
"zkCestice": [],
"glavnaKnjigaId": 265120017
}

Authorization Token

upisnikId INTEGER DA IN
7
rbrPredmeta INTEGER NE IN
datumOsnivanjaPredmeta DATE DA IN
djelatnostId INTEGER DA IN
posaoId INTEGER DA IN
nazivPredmeta STRING NE IN
datumUgovaranjaPosla DATE DA IN
ugovorenaCijena FLOAT NE IN
katastarskaOpcinaMbr INTEGER DA IN
naseljeMbr INTEGER DA IN
lokacija STRING NE IN
brojPlana STRING NE IN
oznakaOvjere INTEGER DA IN
oznakaProvedbe INTEGER DA IN
vrstaStranke* INTEGER DA IN
oibStranke** STRING NE IN
imeStranke* STRING NE IN
prezimeStranke* STRING NE IN
nazivStranke* STRING NE IN
naseljeStrankeMbr** INTGER NE IN
naseljeStrankeNaziv** STRING NE IN
ulicaStrankeRbr** INTEGER NE IN
ulicaStrankeNaziv** STRING NE IN
kucniBrojStranke INTEGER DA IN
kucniPodbrojNStranke INTEGER NE IN
kucniPodbrojAStranke STRING NE IN
isoKodDrzaveStranke** STRING NE IN
brojPosteStranke STRING DA IN
nazivPosteStranke STRING DA IN
kontaktPodaciStranke STRING NE IN
8
vrstaNarucitelja* INTEGER DA IN
oibNarucitelja** STRING NE IN
imeNarucitelja* STRING NE IN
prezimeNarucitelja* STRING NE IN
nazivNarucitelja* STRING NE IN
naseljeNaruciteljaMbr** INTGER NE IN
naseljeNaruciteljaNaziv** STRING NE IN
ulicaNaruciteljaRbr** INTEGER NE IN
ulicaNaruciteljaNaziv** STRING NE IN
kucniBrojNarucitelja INTEGER DA IN
kucniPodbrojNNarucitelja INTEGER NE IN
kucniPodbrojANarucitelja STRING NE IN
isoKodDrzaveNarucitelja** STRING NE IN
brojPosteNarucitelja STRING DA IN
nazivPosteNarucitelja STRING DA IN
kontaktPodaciNarucitelja STRING NE IN
vrstaInvestitora* INTEGER DA IN
oibInvestitora** STRING NE IN
imeInvestitora* STRING NE IN
prezimeInvestitora* STRING NE IN
nazivInvestitora* STRING NE IN
naseljeInvestitoraMbr** INTGER NE IN
naseljeInvestitoraNaziv** STRING NE IN
ulicaInvestitoraNaziv** INTEGER NE IN
ulicaNaruciteljaNaziv** STRING NE IN
kucniBrojInvestitora INTEGER DA IN
kucniPodbrojNInvestitora INTEGER NE IN
kucniPodbrojAInvestitora STRING NE IN
isoKodDrzaveInvestitora** STRING NE IN
brojPosteInvestitora STRING DA IN
9
nazivPosteInvestitora STRING DA IN
kontaktPodaciInvestitora STRING NE IN
ktCestice STRING NE IN
ARRAY
glavnaKnjigaId INTEGER NE IN
zkCestice STRING NE IN
ARRAY
predmetId INTEGER DA OUT
Napomena:
* U slučaju pravne osobe obavezno je poslati parametar naziv, inače je obavezno ime i prezime
** Za RH stranke se šalje OIB, mbr naselja i rbr ulice, za inozemne stranke se šalje naziv
naselja, naziv ulice i službeni ISO kod države
3.6 Dohvat predmeta
Url: /upisnik/getPredmeti
Metoda: Post
Primjer:
{
"upisnikId": 179,
"nazivPredmeta": null,
"rbrPredmeta": null,
"mbrKatastarskeOpcine": 301019
}
Authorization Token

upisnikId INTEGER NE IN
nazivPredmeta STRING NE IN
rbrPredmeta INTEGER NE IN
mbrKatastarskeOpcine INTEGER NE IN
listaPredmeta COMPLEX DA OUT
10
3.6.1 Kompleksni tip predmeta
Naziv atributa Tip Obavezno

predmetId INTEGER DA
upisnikId INTEGER DA
rbrPredmeta INTEGER DA
nazivPredmeta STRING DA
djelatnostId INTEGER DA
nazivDjelatnosti STRING DA
mbrKatastarskeOpcine INTEGER DA
nazivKatastarskeOpcine STRING DA
mbrNaselja INTEGER DA
nazivNaselja STRING DA
datumIzrade DATE DA
datumPromjeneStatusa DATE DA
3.7 Kreiranje elaborata
Url: /elaborat/saveElaborat
Metoda: Post
Primjer:
{
"predmetId": 116041,
"brojElaborata": "1",
"potrebaElaborata": 1,
"svrhaElaborataId": 14,
"metodaIzrade": 1,
"postupakOdrzavanjaDkp": 1,
"koordinatniSustav": 1,
"zkStanje": 0
}

Authorization Token
11
predmetId INTEGER DA IN
brojElaborata INTEGER DA IN
potrebaElaborata INTEGER DA IN
svrhaElaborataId INTEGER DA IN
opisSvrhe STRING NE IN
nazivElaborata STRING NE IN
opisAkta STRING NE IN
zahvatUProstoru STRING NE IN
cestaNaziv STRING NE (samo za svrhu IN
24)
cestaBrCestice STRING NE (samo za svrhu IN
24)
metodaIzrade INTEGER DA IN
postupakOdrzavanjaDKP INTEGER DA IN
koordinatniSustav INTEGER DA IN
zkStanje INTEGER DA IN
projektantId** INTEGER NE IN
glavniProjektant STRING NE IN
kontakt STRING NE IN
primjedbaProjektant STRING NE IN
brojPrimjeraka INTEGER NE IN
elaboratId INTEGER DA OUT
3.8 Dohvat elaborata
Url: /elaborat/getElaborati
Metoda: Post
12
Primjer:
{
"upisnikId": 179,
"predmetId": 711368,
"mbrKatastarskeOpcine": 324574,
"nazivElaborata": "Kastav"
}

Authorization Token

upisnikId INTEGER NE IN
predmetId INTEGER NE IN
brojElaborata INTEGER NE IN
nazivElaborata STRING NE IN
mbrKatastarskeOpcine INTEGER NE IN
listaElaborata COMPLEX DA OUT
3.8.1 Kompleksni tip elaborata

elaboratId INTEGER DA
predmetId INTEGER DA
rbrElaborata INTEGER DA
godinaElaborata INTEGER DA
mbrKatastarskeOpcine INTEGER DA
nazivKatastarskeOpcine STRING DA
metodaIzrade INTEGER DA
postupakOdrzavanjaDKP INTEGER DA
koordinatniSustav INTEGER DA
nazivElaborata STRING NE
13
opisAkta STRING NE
listaSvrha COMPLEX DA
statusElaborata INTEGER DA
Primjedba STRING NE
3.8.2 Kompleksni tip svrha

svrhaElaborataId INTEGER DA
opisSvrhe STRING DA
dodatniOpisSvrhe STRING NE
nazivCeste STRING NE
brojKtCestice STRING NE
3.9 Evidencija zahtjeva za izdavanje podataka
Url: /zahtjev/saveZahtjev
Metoda: Post
Primjer:
{
"elaboratId": 141450,
"datumZahtjeva": "2018-05-08",
"opisZahtjeva": "opis zahtjeva",
"statusZahtjeva": 0
}

Authorization Token

elaboratId INTEGER DA IN
datumZahtjeva DATE DA IN
opisZahtjeva STRING NE IN
datumPreuzimanjaPodataka DATE NE IN
14
statusZahtjeva INTEGER DA IN
zahtjevId INTEGER DA OUT
3.10 Popis zahtjeva za izdavanje podataka u elaborate
Url: /zahtjev/getZahtjevi
Metoda: Post
Primjer:
{
"elaboratId": 141450
}

Authorization Token

listaZahtjeva COMPLEX DA OUT
3.10.1 Kompleksni tip zahtjeva

zahtjevId INTEGER DA
datumZahtjeva DATE DA
opisZahtjeva STRING NE
statusZahtjeva INTEGER DA
datumPreuzimanja DATE NE
15
3.11 Uvoz GML-a
Url: /elaborat/uvozGmlDatoteke
Metoda: Post
Primjer:
{
"zahtjevId": 157510,
"gmlDatoteka": "base64 zip datoteka",
"potvrdaDatoteka": "base 64 pdf datoteka"
}
Napomena: GmlDatoteka se šalje kao zip datoteka dobivena s OSS-a. Datoteka mora sadržavati
podatke za katastarsku općinu koja je upisana na predmet i elaborate. PotvrdaDatoteka je pdf
datoteka (ne šalje se u zipu).
Atribut status označva do koje razine je odrađen uvoz GML-a. Moguće je samo upisati GML u
uvozne tablice, a da upis u čestice elaborata nije izvršen zbog krivog statusa elaborata (odabrano
krivo ZK stanje).
Moguć je samo jedan uvoz za jedan zahtjev. Za naknadni uvoz na isti zahtjev potrebno je brisati
podatke.

Authorization Token

zahtjevId INTEGER DA IN
gmlDatoteka BINARY DA IN
potvrdaDatoteka BINARY DA IN
16
3.12 Dohvat KT prijavnih listova
Url: /ktPrijavniList/getKtPrijavniListovi
Metoda: Post
Primjer:
{
"elaboratId": 141450
}

Authorization Token

listaKtPrijavnihListova COMPLEX DA OUT
3.12.1 Kompleksni tip KT prijavni list

ktPrijavniListId INTEGER DA
rbrLista INTEGER DA
datumIzrade DATE DA
opisPosla STRING NE
statusPromjene INTEGER DA
primjedba STRING NE
17
3.13 Uvoz DXF datoteka
Url: /elaborat/uvozDxfDatoteke
Metoda: Post
Primjer:
{
"ktPrijavniListId": 159320,
"vrstaUklopa": 0,
"datoteka": "base 64 zip koji sadrži dxf datoteku"
}

Authorization Token

ktPrijavniListId INTEGER DA IN
vrstaUklopa INTEGER DA IN
datoteka BINARY DA IN
greske BINARY DA OUT
3.14 Dohvat RPJ naselja
Url: /rpjPodaci/getRpjNaselje
Metoda: Post
Primjer:
{
"nazivNaselja": "bok",
"brojZapisa": 10,
"pomak": 0
}

Authorization Token
18
Parametar Tip Obavezno Vrsta Ograničenje
nazivNaselja STRING DA IN Min 3 znaka
brojZapisa INTEGER DA IN Max 50 zapisa
pomak INTEGER DA IN
rpjNaselja COMPLEX DA OUT
ukupnoZapisa INTEGER DA OUT
3.15 Dohvat RPJ ulica
Url: /rpjPodaci/getRpjUlica
Metoda: Post
Primjer:
{
"nazivUlice": "pan",
"mbrNaselja": "071951",
"brojZapisa": 10,
"pomak": 0
}

Authorization Token

nazivUlice STRING DA IN Min 3 znaka
mbrNaselja STRING DA IN
pomak INTEGER DA IN
rpjUlice COMPLEX DA OUT
19
3.16 Dohvat RPJ katastarskih općina
Url: /rpjPodaci/getRpjKatOpcina
Metoda: Post
Primjer:
{
"nazivKatOpcine": "vuk",
"brojZapisa": 10,
"pomak": 0
}

Authorization Token

nazivKatOpcine STRING DA IN Min 3 znaka
pomak INTEGER DA IN
rpjKatOpcine COMPLEX DA OUT
3.17 Auto-login
Metoda: Get
Url: https://sdge-test.dgu.hr/autoLogin?token=123-123&path=app#!detalji-
elaborata/?elaboratId=123

token STRING DA IN
elaboratId STRING NE IN
predmetId STRING NE IN
20
ktPrijavniListId STRING NE IN
zkPrijavniListId STRING NE IN
Korisnika je moguće preusmjeriti diretktno na sljedeće:

• Detalji predmeta – path: #!detalji-predmeta/?predmetId=123
• Detalji elaborata – path: #!detalji-elaborata/?elaboratId=123
• Detalji kt prijavnog lista – path: #!detalji-kt-prijavnog-lista/?ktPrijavniListId=123
• Detalji zk prijavnog lista – path: #!detalji-zk-prijavnog-lista/?zkPrijavniListId=123
21
4 Šifarnici
4.1 Status kontrole

Opis Vrijednost
Nije utvrđeno 0
Provjera prekinuta 1
Ispravno 2
Ispravno s upozorenjima 3
Neispravno 4
4.2 Vrsta posla

Opis Vrijednost
Cijela katastarska općina 1
Dio katastarske općine 2
Elaborat 3
4.3 Metoda izrade

Opis Vrijednost
Preklop 1
Uklop 2
Preklop i uklop 3
4.4 Oznaka uklopa (Grafički dio)

Opis Vrijednost
Mjerene koordinate 0
Koordinate za održavanje 1
4.5 Pravila kontrole (van PNP)

Opis Vrijednost
Specifikacija za vektorizaciju 1
TS_DKP 2
22
4.6 Vrsta plana (van PNP)
Opis Vrijednost
Nove izmjere 1
Stari planovi 2
4.7 Stanje podataka

Opis Vrijednost
Osnovno stanje 1
Staro i novo stanje 2
4.8 Vrsta stranke

Opis Vrijednost
Nije pravna osoba 0
Pravna osoba 1
4.9 Potreba elaborata

Opis Vrijednost
Održavanje katastra nekretnina 1
Postupno osnivanje katastra nekretnina 2
Provođenje promjena u katastru zemljišta 3
4.10 Postupak održavanja DKP

Opis Vrijednost
Postupak 1 1
Postupak 2 2
Postupak 3 3
Postupak 4 4
4.11 Koordinatni sustav

Opis Vrijednost
HTSR96 1
HDKS 2
23
4.12 ZK stanje
Opis Vrijednost
Nema ZK stanje 0
Isto KT i ZK stanje 1
Dvostruko KT i ZK stanje 2
4.13 Oznaka ovjere

Opis Vrijednost
Ne podliježe pregledu i ovjeri 0
Podliježe pregledu i ovjeri 1
4.14 Oznaka provedbe

Opis Vrijednost
Ne provodi se u katastarskom operatu 0
Provodi se u katastarskom operatu 1
4.15 Status zahtjeva

Opis Vrijednost
Zahtjev je predan 0
Podaci su preuzeti 1
4.16 Status promjene prijavnog lista

Opis Vrijednost
Bez promjene 0
U pripremi 1
Promjena formirana 2
Promjena provedena 3
4.17 ApiStatus
Opis Vrijednost
Greška u servisu 0
24
Metoda uspješno izvršena 1
4.18 Status GML uvoza

Opis Vrijednost
Greška kod uvoza 0
Uvoz uspješan 1
Greka kod prijepisa u čestice elaborate 2
25
5 Servisi za šifarnike
5.1 Dohvat šifarnika Djelatnost
Url: /upisnik/getDjelatnosti
Metoda: Post

Authorization Token

djelatnosti OBJECT LIST DA OUT
(INTEGER +
STRING)
5.2 Dohvat šifarnika Posao
Url: /upisnik/getPoslovi
Metoda: Post
Primjer:
{
"djelatnostId": 25
}

Authorization Token

djelatnostId INTEGER DA IN
poslovi OBJECT LIST DA OUT
(INTEGER +
STRING)
26
5.3 Dohvat šifarnika Svrha elaborata
Url: /elaborat/getSvrheElaborata
Metoda: Post

Authorization Token

svrheElaborata OBJECT LIST DA OUT
(INTEGER +
STRING)
27
6 Vanjski šifarnici
Šifarnici vanjskih izvora:
• RPJ – mogu se koristiti vrijednosti dobivene iz RPJ-a ili vrijednosti koje SDGE nudi za
pretragu objekata RPJ-a. SDGE ažurira interni šifarnik RPJ-a svaki dan za dan unatrag.
o Katastarske općine
o Naselja
o Ulice
• HP – šifarnici se preuzimaju sa stranica Hrvatske pošte (url:
https://www.posta.hr/preuzimanje-podataka-o-postanskim-uredima-6543/6543)
o Poštanski broj
o Naziv dostavnog područja
28

SDGE Rest Specifikacija v1.2

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

SDGE Rest Specifikacija v1.2

Uploaded by

Copyright:

Available Formats

REPUBLIKA HRVATSKA

DRŽAVNA GEODETSKA UPRAVA

SDGE REST API SPECIFIKACIJA

REST API je programsko sučelje aplikacije zasnovano na REST (Reprezentacijsko stanje

Za metode uvoza i konverzije podataka potrebno je prenošenje cijelih datoteka. Zbog

Za pristup korištenju SDGE-u potrebno je za postojećeg korisnika kreirati autentikacijski ključ i

• Testno (pred-produkcijsko) okruženje: https://sdge-test.dgu.hr/services/rest

• Produkcijsko okruženje: https://sdge.dgu.hr/services/rest

3.1 Dohvat autentifikacijskog tokena

Parametar zaglavlja Vrijednost

Parametar Tip Obavezno Vrsta

Koristi se „Basic autentikacija“ kojom se šalje autentifikacijski token i lozinka enkodirani u

3.2 Kontrola kvalitete

Parametar Tip Obavezno Vrsta

Parametar zaglavlja Vrijednost

Parametar Tip Obavezno Vrsta

3.4 Dohvat upisnika

Parametar zaglavlja Vrijednost

3.5 Kreiranje predmeta

Parametar zaglavlja Vrijednost

Parametar Tip Obavezno Vrsta

3.6 Dohvat predmeta

Parametar Tip Obavezno Vrsta

3.6.1 Kompleksni tip predmeta

Naziv atributa Tip Obavezno

3.7 Kreiranje elaborata

Parametar zaglavlja Vrijednost

3.8 Dohvat elaborata

Parametar zaglavlja Vrijednost

Parametar Tip Obavezno Vrsta

3.8.1 Kompleksni tip elaborata

Naziv atributa Tip Obavezno

3.8.2 Kompleksni tip svrha

3.9 Evidencija zahtjeva za izdavanje podataka

Parametar zaglavlja Vrijednost

Parametar Tip Obavezno Vrsta

3.10 Popis zahtjeva za izdavanje podataka u elaborate

Parametar zaglavlja Vrijednost

Parametar Tip Obavezno Vrsta

3.10.1 Kompleksni tip zahtjeva

Parametar zaglavlja Vrijednost

Parametar Tip Obavezno Vrsta

Parametar zaglavlja Vrijednost

Parametar Tip Obavezno Vrsta

3.12.1 Kompleksni tip KT prijavni list

Naziv atributa Tip Obavezno

Parametar zaglavlja Vrijednost

Parametar Tip Obavezno Vrsta

3.14 Dohvat RPJ naselja

Parametar zaglavlja Vrijednost

3.15 Dohvat RPJ ulica

Parametar zaglavlja Vrijednost

Parametar Tip Obavezno Vrsta Ograničenje

Parametar zaglavlja Vrijednost

Parametar Tip Obavezno Vrsta Ograničenje

Parametar Tip Obavezno Vrsta

Korisnika je moguće preusmjeriti diretktno na sljedeće:

4.1 Status kontrole

4.2 Vrsta posla

4.3 Metoda izrade

4.4 Oznaka uklopa (Grafički dio)

4.5 Pravila kontrole (van PNP)

4.7 Stanje podataka