Verzija 3.0.4

Objavljeno xx.0y.2025

• Dodani tag-ovi "Glavna knjiga", "Šifrarnici" i "Ostalo" na metode u Open API shemi
• Dodana kratica valute u šifrarnik valuta
• Polje ime u prijevodima skraćenih tvrtki je ispravljeno iz neobaveznog u obavezno (NOT NULL)
• Polje scn_zadnje_izmjene u detaljima subjekta sada vraća 0 umjesto NULL ukoliko sustav nema evidentiranu ni jednu promjenu za subjekt od kraja 2016. godine kada je uvedeno praćenja SCN-a
• Više nije preporučeno koristiti element promjene u detaljima subjekta, jer su isti podaci dostupni kroz polja scn_zadnje_izmjene i vrijeme_zadnje_izmjene
• U javne servise su dodani podaci o statusnim postupcima, partnerima statusnih postupaka i vrstama statusnih postupaka
• Sitne dorade dokumentacije i optimizacija elemenata Open API specifikacije

Verzija 3.0.3

Objavljeno 11.11.2024

• Ispravke Open API shema ds_gfi, ds_gfi_ex, ds_promjene, ds_promjene_ex kako bi specifikacija odgovarala stvarno vraćenim podacima. U prethodnim verzijama su sheme sadržale dodatni xxx_povijest sub array koji u starnosti ne postoji.

Verzija 3.0.2

Objavljeno 04.08.2024

• Ispravke Open API specifikacije za metodu detalji_subjekta kako bi specifikacija odgovarala stvarno vraćenim podacima

Verzija 3.0.1

Objavljeno 18.06.2024

• Dodan je potpuni_oib (formatiran kao tekst sa 11 znamenki i vodećim nulama) u metodi detalji_subjekta
• U metodi valuta za legacy servise je ispravljen naziv elementa drzava_Id u drzava_id
• Dodan je nedostajući parametar tvrtka_naziv u legacy metodu subjekt i v3 metodu subjekti
• Dodan je parametar no_data_error pomoću kojeg se u većini metoda može odabrati treba li metoda vratiti grešku 505 ili prazni objekt kada nema traženih podataka
• Dodan je changelog
• Dodan je SwaggerHub za javne servise https://app.swaggerhub.com/apis/mpu.gov.hr/sudreg_javni/

Verzija 3.0.0

Servisi su migrirani sa Azure API Management na Oracle platformu

• Imena svih metoda su pretvorena u množinu i po potrebi ispravljena.
• Metoda timestamp (i timestamp_id) je preimenovana u logičniji naziv snapshots. Dosadašnja polja/parametri timestamp_id su preimenovana u snapshot_id, a tip im je radi performansi promijenjen iz GUID-a u bazni NUMBER(10), što odgovara Int64 u većini jezika. Metoda sada vraća i dva dodatna polja: available_until i staleness. Prvo predstavlja minimalni datum i vrijeme do kada će set garantirano biti dostupan, drugi predstavlja "svježinu" seta, 1 - zadnji set, 2 - predzadnji set itd.
• Izlazni parametar X-Timestamp-Id se sada zove X-Snapshot-Id i reprezentiran je kao broj u skladu sa snapshot_id parametrom. Valja primijetiti da se ime nije mijenjalo za polje SNAPSHOTS.TIMESTAMP (koji predstavlja vrijeme kopiranja snimke s produkcije), kao ni za povezani izlazni parametar X-Timestamp
• Iz tehničkih razloga osnovni URL je promijenjen, a promijenjeni su i URL-ovi samih metoda u skladu s novim imenima.
    Test: https://sudreg-data-test.gov.hr/api/javni
    Produkcija: https://sudreg-data.gov.hr/api/javni


• Svi vremenski podaci (shapshot.timestamp i available_until, datumi rođenja, osnivanja i sl.) se sada navode bez oznake ZULU vremena, odnosno bez oznake vremenske zone. Ovo je napravljeno jer odgovarajući podaci u aplikaciji Sudskog registra ne vode vremensku zonu i nema ju smisla implicirati u otvorenim podacima.
• Ispravljena su mnoga imena metoda i kolona.
• Uvedene su legacy metode koje se ponašaju vrlo slično postojećim v1 i v2 metodama za državna tijela i metodama za javne korisnike i kod kojih su zadržana postojeća imena gdje god je bilo moguće.
• Ključevi/elementi s default vrijednostima (tipa status = 0) se više ne izostavljaju iz odgovora, te je ovo ponašanje sad usklađeno kroz sve metode i servise.
• Ključevi/elementi s praznim (NULL) vrijednostima (sud_id = null) se i dalje izostavljaju iz odgovora radi performansi, ali ovo ponašanje se može kontrolirati putem novog parametra omit_nulls. Ovo ponašanje je sad usklađeno kroz sve metode i servise.
• Dodana je metoda counts koja vraća ukupan broj aktivnih i svih redaka za svaku tablicu/metodu. Kod tablica koje ne vode oznaku aktivnih redaka odnosno ne označavaju posebno retke kao aktivne ili neaktivne, broj aktivnih redaka je upisan kao 0 i vodi se samo ukupan broj redaka.
• Dodani su novi ulazni parametri
   o Content-Type, navodi se u header-u zahtjeva, nije obavezan, određuje format odgovora [application/json|application/xml]
   o snapshot_id, zamjena za timestamp_id s identičnim ponašanjem, nije obavezan, zadaje snimku podataka koja se preuzima, ako se ne zada vraća se najnovija snimka
   o omit_nulls, nije obavezan, zadaje da li se prazni (null) ključevi izostavljaju iz vraćenih podataka, ako se ne navede prazni ključevi se izostavljaju


• Izmijenjeni su postojeći ulazni parametri i usklađeno je ponašanje kroz sve metode za
   o only_active, nije obavezan, zadaje da li se vraćaju svi podaci ili samo aktivni podaci, ako se ne zada vraćaju se samo aktivni podaci
   o expand_relations, nije obavezan, zadaje da li se podaci iz vezanih šifrarnika dodaju u odgovor ili se uključuje samo ID stranog ključa, ako se ne zada vraćaju se samo ID-evi
   o offset, nije obavezan, zadaje redni broj (0-based) prvog retka koji se vraća kod paging-a, ako se ne navede vraćaju se podaci od prvog retka
   o limit, nije obavezan, zadaje broj redaka (veličinu stranice) kod paging-a, ako se ne navede vraća se 1000 redaka


• Dodani su novi izlazni header parametri
   o X-Snapshot-Id, zamjena za dosadašnji X-Timestamp-Id, predstavlja snapshot_id (ID snimke) podataka koji se koristi za odgovor
   o X-Seconds-Elapsed, vrijeme koje je potrošeno za dohvat podataka, ne uključuje vrijeme prijenosa preko mreže
   o X-Rows-Returned, broj redaka vraćenih u odgovoru
   o X-Log-Id, id log zapisa za odgovor, koristi se u komunikaciji sa službom za korisnike


• Ispravljena je metoda gfi, gdje gfi_rbr sada ispravno predstavlja redni broj GFI dokumenta unutar subjekta (rbr za svaki subjekt kreće od 1), umjesto kao sada unutar cijelog registra
• Ispravljena je metoda sud, gdje se do sada sud neispravno vodio kao nadležan samom sebi, a sad je nadležan sud ispravno naveden kao null. Ovo se odnosi i na javne servise.
• Dodane su nove metode

Odstupanja legacy metoda od starih servisa

• promijenio se bazni URL
• koristi se OAuth2 proces autentikacije
• timestamp vrijednost je i za legacy metode tehnički gledano broj, no kod poziva i u izlaznim parametrima se formatira kao GUID, npr. 143 ==> 00000000-0000-0000-0000-000000000143 kako bi se zadržala kompatibilnost s postojećim klijentima
• Svi vremenski podaci (shapshot.timestamp i available_until, datumi rođenja, osnivanja i sl.) se sada navode bez oznake ZULU vremena, odnosno bez oznake vremenske zone. Ovo je napravljeno jer odgovarajući podaci u aplikaciji Sudskog registra ne vode vremensku zonu i nema ju smisla implicirati u otvorenim podacima.
• metoda bris_pravni_oblik je vraćala prazni ključ kratica umjesto da ga izostavi iz odgovora, legacy metoda ga izostavlja
• metoda evidencijske_djelatnosti je u parametru X-Total-Count pogrešno vraćala broj svih redaka umjesto broja aktivnih redaka, legacy metoda vraća ispravan broj. Istovremeno je u rezultatima vraćala i neaktivne retke.
• Ispravljena je metoda gfi, gdje gfi_rbr sada ispravno predstavlja redni broj GFI dokumenta unutar subjekta (rbr za svaki subjekt kreće od 1), umjesto kao sada unutar cijelog registra
• Ključevi/elementi s default vrijednostima (tipa status = 0) se više ne izostavljaju iz odgovora, te je ovo ponašanje sad usklađeno kroz sve metode i servise.