Upute za korištenje
Početna stranica

Narodne novine API

This page is available in English.

Uvod


API (Application Programming Interface) skup je protokola i alata koji različitim softverskim programima omogućuje interakciju sa softverskom aplikacijom ili uslugom temeljenom na webu. Programerima omogućuje pristup određenim značajkama ili podacima iz aplikacije ili usluge bez potrebe za razumijevanjem njezinog temeljnog koda ili infrastrukture. API pozivi koji su implementirani u nastavku omogućuju vam dohvaćanje metapodataka iz NN publikacija.

I - Metapodatci propisa


Dohvaćanje metapodataka propisa specificiranog vrstom (SL/MU), godinom, brojem izdanja i brojem akta.

Krajnja točka: https://narodne-novine.nn.hr/api/act
Metoda: HTTP POST
Format: Unos JSON, ishod JSON-LD ili RDF/XML
Ulazni parametri:
 "part" (string) - može biti samo "SL" (službeni) ili "MU" (međunarodni)
 "year" (int) - predstavlja četveroznamenkasti broj, označava službenu godinu izlaženja časopisa
 "number" (int) - predstavlja pozitivan broj, označava broj časopisa unutar odabrane godine
 "act_num" (string) - predstavlja broj akta (vrlo rijetko sadrži slovo)
 "format" (string) - predstavlja izlazni format i može biti samo "JSON-LD" ili "RDF/XML"
Ishod: JSON-LD ili RDF/XML

Ova metoda vraća metapodatke samo za izdanja koja su objavljena i imaju ELI metapodatke. Ne radi s dijelom OG (oglasi). Dopušteni dio je samo "SL" ili "MU", a format samo "JSON-LD" ili "RDF/XML". Svi ulazni parametri su obavezni.

Primjer 1: Unos
{
 "part": "SL",
 "year": 2023,
 "number": 34,
 "act_num": "596",
 "format": "RDF/XML"
}
Primjer 1: Ishod
<?xml version="1.0" encoding="utf-8" ?>
 <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:eli="http://data.europa.eu/eli/ontology#">
 <rdf:Description rdf:about="https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596">

   <rdf:type rdf:resource="http://data.europa.eu/eli/ontology#LegalResource"/>
   <eli:type_document rdf:resource="https://narodne-novine.nn.hr/resource/authority/document-type/UREDBA"/>
   <eli:number rdf:datatype="http://www.w3.org/2001/XMLSchema#string">596</eli:number>
   <eli:date_document rdf:datatype="http://www.w3.org/2001/XMLSchema#date">2023-03-27</eli:date_document>
   <eli:date_publication rdf:datatype="http://www.w3.org/2001/XMLSchema#date">2023-03-27</eli:date_publication>
   <eli:passed_by rdf:resource="https://narodne-novine.nn.hr/eli/vocabularies/nn-institutions/19560"/>
   <eli:is_realized_by rdf:resource="https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv"/>
   <eli:is_about rdf:resource="http://eurovoc.europa.eu/1072"/>
   <eli:is_about rdf:resource="http://eurovoc.europa.eu/2652"/>
   <eli:is_about rdf:resource="http://eurovoc.europa.eu/2679"/>
   <eli:is_about rdf:resource="http://eurovoc.europa.eu/2772"/>
   <eli:is_about rdf:resource="https://narodne-novine.nn.hr/eli/vocabularies/nn-legal-area/20"/>
   <eli:is_about rdf:resource="https://narodne-novine.nn.hr/eli/vocabularies/nn-legal-area/28"/>
   <eli:is_about rdf:resource="https://narodne-novine.nn.hr/eli/vocabularies/nn-content-type/1"/>
   <eli:is_about rdf:resource="https://narodne-novine.nn.hr/eli/vocabularies/nn-index-terms/288"/>
   <eli:is_about rdf:resource="https://narodne-novine.nn.hr/eli/vocabularies/nn-index-terms/2152"/>
   <eli:is_about rdf:resource="https://narodne-novine.nn.hr/eli/vocabularies/nn-index-terms/2312"/>
 </rdf:Description>

 <eli:LegalExpression rdf:about="https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv">
   <eli:publisher rdf:datatype="http://www.w3.org/2001/XMLSchema#string">Narodne novine</eli:publisher>
   <eli:realizes rdf:resource="https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596"/>
   <eli:language rdf:resource="http://publications.europa.eu/resource/authority/language/HRV"/>
   <eli:title rdf:datatype="http://www.w3.org/2001/XMLSchema#string">Uredba o utvrđivanju najviših maloprodajnih cijena naftnih derivata</eli:title>
   <eli:is_embodied_by>
    <eli:Format rdf:about="https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv/html">
     <eli:publisher rdf:datatype="http://www.w3.org/2001/XMLSchema#string">Narodne novine</eli:publisher>
     <eli:embodies rdf:resource="https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv"/>
     <eli:format rdf:resource="http://www.iana.org/assignments/media-types/text/html"/>
    </eli:Format>
   </eli:is_embodied_by>
   <eli:is_embodied_by>
    <eli:Format rdf:about="https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv/printhtml">
     <eli:publisher rdf:datatype="http://www.w3.org/2001/XMLSchema#string">Narodne novine</eli:publisher>
     <eli:embodies rdf:resource="https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv"/>
     <eli:format rdf:resource="http://www.iana.org/assignments/media-types/text/html"/>
    </eli:Format>
   </eli:is_embodied_by>
   <eli:is_embodied_by>
    <eli:Format rdf:about="https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv/pdf">
     <eli:publisher rdf:datatype="http://www.w3.org/2001/XMLSchema#string">Narodne novine</eli:publisher>
     <eli:embodies rdf:resource="https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv"/>
     <eli:format rdf:resource="http://www.iana.org/assignments/media-types/application/pdf"/>
    </eli:Format>
   </eli:is_embodied_by>
 </eli:LegalExpression>
</rdf:RDF>

Primjer 2: Unos
{
 "part": "SL",
 "year": 2023,
 "number": 34,
 "act_num": "596",
 "format": "JSON-LD"
}
Primjer 2: Ishod
[
 { "@id": "http://data.europa.eu/eli/ontology#LegalResource" },
 { "@id": "https://narodne-novine.nn.hr/resource/authority/document-type/UREDBA" },
 { "@id": "https://narodne-novine.nn.hr/eli/vocabularies/nn-institutions/19560" },
 { "@id": "http://data.europa.eu/eli/ontology#LegalExpression" },
 { "@id": "http://publications.europa.eu/resource/authority/language/HRV" },
 { "@id": "http://data.europa.eu/eli/ontology#Format" },
 { "@id": "http://www.iana.org/assignments/media-types/text/html" },
 { "@id": "http://www.iana.org/assignments/media-types/application/pdf" },
 { "@id": "http://eurovoc.europa.eu/1072" },
 { "@id": "http://eurovoc.europa.eu/2652" },
 { "@id": "http://eurovoc.europa.eu/2679" },
 { "@id": "http://eurovoc.europa.eu/2772" },
 { "@id": "https://narodne-novine.nn.hr/eli/vocabularies/nn-legal-area/20" },
 { "@id": "https://narodne-novine.nn.hr/eli/vocabularies/nn-legal-area/28" },
 { "@id": "https://narodne-novine.nn.hr/eli/vocabularies/nn-content-type/1" },
 { "@id": "https://narodne-novine.nn.hr/eli/vocabularies/nn-index-terms/288" },
 { "@id": "https://narodne-novine.nn.hr/eli/vocabularies/nn-index-terms/2152" },
 { "@id": "https://narodne-novine.nn.hr/eli/vocabularies/nn-index-terms/2312" },
 { "@id": "https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596",
   "@type": [ "http://data.europa.eu/eli/ontology#LegalResource" ],
   "http://data.europa.eu/eli/ontology#type_document": [
    { "@id": "https://narodne-novine.nn.hr/resource/authority/document-type/UREDBA" }
   ],
   "http://data.europa.eu/eli/ontology#number": [
    { "@value": "596" }
   ],
   "http://data.europa.eu/eli/ontology#date_document": [
    {
     "@value": "2023-03-27",
     "@type": "http://www.w3.org/2001/XMLSchema#date"
    }
   ],
   "http://data.europa.eu/eli/ontology#date_publication": [
    {
     "@value": "2023-03-27",
     "@type": "http://www.w3.org/2001/XMLSchema#date"
    }
   ],
   "http://data.europa.eu/eli/ontology#passed_by": [
    { "@id": "https://narodne-novine.nn.hr/eli/vocabularies/nn-institutions/19560" }
   ],
   "http://data.europa.eu/eli/ontology#is_realized_by": [
    { "@id": "https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv" }
   ],
   "http://data.europa.eu/eli/ontology#is_about": [
    { "@id": "http://eurovoc.europa.eu/1072" },
    { "@id": "http://eurovoc.europa.eu/2652" },
    { "@id": "http://eurovoc.europa.eu/2679" },
    { "@id": "http://eurovoc.europa.eu/2772" },
    { "@id": "https://narodne-novine.nn.hr/eli/vocabularies/nn-legal-area/20" },
    { "@id": "https://narodne-novine.nn.hr/eli/vocabularies/nn-legal-area/28" },
    { "@id": "https://narodne-novine.nn.hr/eli/vocabularies/nn-content-type/1" },
    { "@id": "https://narodne-novine.nn.hr/eli/vocabularies/nn-index-terms/288" },
    { "@id": "https://narodne-novine.nn.hr/eli/vocabularies/nn-index-terms/2152" },
    { "@id": "https://narodne-novine.nn.hr/eli/vocabularies/nn-index-terms/2312" }
   ]
  },
  {
   "@id": "https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv",
   "@type": [ "http://data.europa.eu/eli/ontology#LegalExpression" ],
   "http://data.europa.eu/eli/ontology#publisher": [
    { "@value": "Narodne novine" }
   ],
   "http://data.europa.eu/eli/ontology#realizes": [
    { "@id": "https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596" }
   ],
   "http://data.europa.eu/eli/ontology#language": [
    { "@id": "http://publications.europa.eu/resource/authority/language/HRV" }
   ],
   "http://data.europa.eu/eli/ontology#title": [
    { "@value": "Uredba o utvrđivanju najviših maloprodajnih cijena naftnih derivata" }
   ],
   "http://data.europa.eu/eli/ontology#is_embodied_by": [
    { "@id": "https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv/html" },
    { "@id": "https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv/printhtml" },
    { "@id": "https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv/pdf" }
   ]
  },
  {
   "@id": "https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv/html",
   "@type": [ "http://data.europa.eu/eli/ontology#Format" ],
   "http://data.europa.eu/eli/ontology#publisher": [
    { "@value": "Narodne novine" }
   ],
   "http://data.europa.eu/eli/ontology#embodies": [
    { "@id": "https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv" }
   ],
   "http://data.europa.eu/eli/ontology#format": [
    { "@id": "http://www.iana.org/assignments/media-types/text/html" }
   ]
  },
  {
   "@id": "https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv/printhtml",
   "@type": [ "http://data.europa.eu/eli/ontology#Format" ],
   "http://data.europa.eu/eli/ontology#publisher": [
    { "@value": "Narodne novine" }
   ],
   "http://data.europa.eu/eli/ontology#embodies": [
    { "@id": "https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv" }
   ],
   "http://data.europa.eu/eli/ontology#format": [
    { "@id": "http://www.iana.org/assignments/media-types/text/html" }
   ]
  },
  {
   "@id": "https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv/pdf",
   "@type": [ "http://data.europa.eu/eli/ontology#Format" ],
   "http://data.europa.eu/eli/ontology#publisher": [
    { "@value": "Narodne novine" }
   ],
   "http://data.europa.eu/eli/ontology#embodies": [
    { "@id": "https://narodne-novine.nn.hr/eli/sluzbeni/2023/34/596/hrv" }
   ],
   "http://data.europa.eu/eli/ontology#format": [
    { "@id": "http://www.iana.org/assignments/media-types/application/pdf" }
   ]
  }
]

II - Godine s dostupnim ELI metapodatcima


Dohvaćanje raspona godina za koje su dostupni ELI metapodatci.

Krajnja točka: https://narodne-novine.nn.hr/api/index
Metoda: HTTP GET
Format: Ishod JSON
Ulazni parametri: Nijedan
Ishod: Popis godina

Ova metoda vraća samo niz godina za izdanja koja su objavljena i imaju ELI metapodatke. Ne radi s dijelom OG (oglasi). Ne zahtijeva nikakve ulazne parametre.

Primjer: Ishod
[2015,2016,2017,2018,2019,2020,2021,2022,2023]

III - Izdanja s dostupnim ELI metapodatcima


Dohvaćanje popisa svih brojeva izdanja za traženu godinu.

Krajnja točka: https://narodne-novine.nn.hr/api/editions
Metoda: HTTP POST
Format: Unos JSON, ishod JSON
Ulazni parametri:
 "part" (string) - može biti samo "SL" (službeni) ili "MU" (međunarodni)
 "year" (int) - predstavlja četveroznamenkasti broj, označava službenu godinu izlaženja časopisa
Ishod: Popis brojeva izdanja

Ova metoda vraća raspon godina samo za izdanja koja su objavljena i imaju ELI metapodatke. Ne radi s dijelom OG (oglasi). Ne zahtijeva nikakve ulazne parametre.

Primjer: Unos
{
 "part": "SL",
 "year": 2023
}
Primjer: Ishod
[1,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,19,20,21,22,23,24,25,26,27,28,29,30,31,32,35,33,34,36]

IV - Propisi s dostupnim ELI metapodatcima


Dohvaćanje popisa svih propisa koji se pojavljuju u određenom izdanju koje ima ELI metapodatke.

Krajnja točka: https://narodne-novine.nn.hr/api/acts
Metoda: HTTP POST
Format: Unos JSON, ishod JSON
Ulazni parametri:
 "part" (string) - može biti samo "SL" (službeni) ili "MU" (međunarodni)
 "year" (int) - predstavlja četveroznamenkasti broj, označava službenu godinu izlaženja časopisa
 "number" (int) - predstavlja pozitivan broj, označava broj časopisa unutar odabrane godine
Ishod: Popis brojeva propisa

Ova metoda vraća samo sve propise koji su u objavljenom izdanju i imaju ELI metapodatke. Ne radi s dijelom OG (oglasi). Dopušteni dio je samo "SL" ili "MU". Svi ulazni parametri su obavezni.

Primjer: Unos
{
 "part": "SL",
 "year": 2023,
 "number": 34
}
Primjer: Ishod
["602","601","598","597","599","600","596"]

V - API ograničenja


Ulazni parametri za svaki poziv provjeravaju se i vraćaju pogrešku ako nisu valjani ili su prazni.

API poziv ima ograničenje od 3 zahtjeva u sekundi, što znači da bilo koji dodatni zahtjevi izvan tog ograničenja neće biti obrađeni. Ovo ograničenje postoji kako bi se spriječilo preopterećenje servera i osiguralo pošteno korištenje za sve korisnike.




Verzija dokumenta 1.0, 18. travnja 2023.