Základná URL pre prístup k API: https://www.normoff.gov.sk/api/

Objednávky

Čítať objednávky podľa dátumu

Metóda: GET

Prístup: /objednavky/{mesiac}/{rok}/

Parametre

• {mesiac} - [povinné] mesiac, z ktorého chceme zobraziť objednávky
• {rok} - [povinné] rok, z ktorého chceme zobraziť objednávky

Odpovede

Kód	Popis
200	Úspešná operácia
404	Nenájdené žiadne záznamy pre danú požiadavku

Formát odpovede

V prípade úspechu

Vráti pole všetkých objednávok vyhovujúcim parametrom.

• pole objednávok
  • cislo - číslo objednávky
  • dodavatel - adresa a meno dodávateľa objednávky
  • dodavatel_ico - IČO dodávateľa objednávky
  • predmet - predmet objednávky
  • sumasdph - suma objednávky vrátane DPH
  • datum - dátum vystavenia objednávky
  • schvalil - meno osoby schvaľujúcej objednávku
  • schvalil_funkcia - funkcia osoby schvaľujúcej objednávku
  • mena - mena objednávky

Príklad:

[
   {
      "cislo":"4200002385",
      "dodavatel":"VILLA PRO, s.r.o., 052 01 Spišská Nová Ves, Chrapèiakova 1",
      "dodavatel_ico":"31682731",
      "predmet":"Objednávame u Vás dodanie a inštaláciu ramien pre závoru vjazd a výjazd",
      "sumasdph":480.48,
      "datum":"2021-06-01",
      "schvalil":"Ing. Ľubica Urbanová",
      "schvalil_funkcia":"generálna tajomníčka služobného úradu",
      "mena":"EUR"
   },
   {
      "cislo":"4500001133",
      "dodavatel":"Up Slovensko, s.r.o., 821 01 Bratislava, Tomášikova 23\/D",
      "dodavatel_ico":"31396674",
      "predmet":"Objednávame u Vás stravné lístky",
      "sumasdph":8640,
      "datum":"2021-06-01",
      "schvalil":"Ing. Ľubica Urbanová",
      "schvalil_funkcia":"generálna tajomníčka služobného úradu",
      "mena":"EUR"
   }
]

V prípade chyby

Vráti objekt s parametrom error s popisom chyby

• error - popis chyby

Príklad:

{
    "error":"Parameter 'month' out of range."
}

Čítať objednávky podľa dodávateľa

Metóda: GET

Prístup: /objednavky/{dodavatel}/

Parametre

• {dodavatel} - [povinné] názov dodávateľa alebo jeho IČO

Odpovede

Kód	Popis
200	Úspešná operácia
404	Nenájdené žiadne záznamy pre danú požiadavku

Formát odpovede

V prípade úspechu

Vráti pole všetkých objednávok vyhovujúcim parametrom.

• pole objednávok
  • cislo - číslo objednávky
  • dodavatel - adresa a meno dodávateľa objednávky
  • dodavatel_ico - IČO dodávateľa objednávky
  • predmet - predmet objednávky
  • sumasdph - suma objednávky vrátane DPH
  • datum - dátum vystavenia objednávky
  • schvalil - meno osoby schvaľujúcej objednávku
  • schvalil_funkcia - funkcia osoby schvaľujúcej objednávku
  • mena - mena objednávky

Príklad:

[
   {
      "cislo":"4200001509",
      "dodavatel":"ASIANA, spol. s.r.o., 160 00 Praha, Velflíkova 8",
      "dodavatel_ico":"49704362",
      "predmet":"Objednávame u Vás obojsmernú letenku",
      "sumasdph":"",
      "datum":"2017-11-08",
      "schvalil":"Ing. František Daniš",
      "schvalil_funkcia":"generálny tajomník služobného úradu",
      "mena":"EUR"
   },
   {
      "cislo":"4200001515",
      "dodavatel":"ASIANA, spol. s.r.o., 160 00 Praha, Velflíkova 8",
      "dodavatel_ico":"49704362",
      "predmet":"Objednávame u Vás obojsmernú letenku",
      "sumasdph":"",
      "datum":"2017-11-13",
      "schvalil":"Ing. František Daniš",
      "schvalil_funkcia":"generálny tajomník služobného úradu",
      "mena":"EUR"
   }
]

V prípade chyby

Vráti objekt s parametrom error s popisom chyby

• error - popis chyby

Príklad:

{
    "error":"Parameter 'customer' cannot be empty."
}

Faktúry

Čítať faktúry podľa dátumu

Metóda: GET

Prístup: /faktury/{mesiac}/{rok}/

Parametre

• {mesiac} - [povinné] mesiac, z ktorého chceme zobraziť faktúry
• {rok} - [povinné] rok, z ktorého chceme zobraziť faktúry

Odpovede

Kód	Popis
200	Úspešná operácia
404	Nenájdené žiadne záznamy pre danú požiadavku

Formát odpovede

V prípade úspechu

Vráti pole všetkých faktúr vyhovujúcim parametrom.

• pole faktúr
  • cislo - číslo faktúry
  • dodavatel - adresa a meno dodávateľa faktúry
  • dodavatel_ico - IČO dodávateľa faktúry
  • predmet - predmet faktúry
  • sumasdph - suma faktúry vrátane DPH
  • objednávka - identifikátor objednávky patriacej k faktúre
  • schvalil_funkcia - funkcia osoby schvaľujúcej objednávku
  • mena - mena faktúry

Príklad:

[
   {
      "cislo":"0000310250\/2021",
      "dodavatel":"FAST PLUS, a.s., 831 06 Bratislava, Na pántoch 18",
      "dodavatel_ico":"35712783",
      "predmet":"kávovar",
      "sumasdph":301.21,
      "datum":"2021-06-01",
      "objednavka":"4500001128",
      "mena":"EUR"
   },
   {
      "cislo":"0000310251\/2021",
      "dodavatel":"SPB Security s.r.o., 851 01 Bratislava, Kremnická 26",
      "dodavatel_ico":"44626975",
      "predmet":"strážna služba 5\/21",
      "sumasdph":10535.04,
      "datum":"2021-06-01",
      "objednavka":"0000000000",
      "mena":"EUR"
   }
]

V prípade chyby

Vráti objekt s parametrom error s popisom chyby

• error - popis chyby

Príklad:

{
    "error":"Parameter 'month' out of range."
}

Čítať faktúry podľa dodávateľa

Metóda: GET

Prístup: /faktury/{dodavatel}/

Parametre

• {dodavatel} - [povinné] názov dodávateľa alebo jeho IČO

Odpovede

Kód	Popis
200	Úspešná operácia
404	Nenájdené žiadne záznamy pre danú požiadavku

Formát odpovede

V prípade úspechu

Vráti pole všetkých faktúr vyhovujúcim parametrom.

• pole faktúr
  • cislo - číslo faktúry
  • dodavatel - adresa a meno dodávateľa faktúry
  • dodavatel_ico - IČO dodávateľa faktúry
  • predmet - predmet faktúry
  • sumasdph - suma faktúry vrátane DPH
  • objednávka - identifikátor objednávky patriacej k faktúre
  • schvalil_funkcia - funkcia osoby schvaľujúcej objednávku
  • mena - mena faktúry

Príklad:

[
   {
      "cislo":"0000310626\/2017",
      "dodavatel":"ASIANA, spol. s.r.o., 160 00 Praha, Velflíkova 8",
      "dodavatel_ico":"49704362",
      "predmet":"VIE-BRU-VIE Miretinsky",
      "sumasdph":650.01,
      "datum":"2017-11-08",
      "objednavka":"4200001509",
      "mena":"EUR"
   },
   {
      "cislo":"0000310634\/2017",
      "dodavatel":"ASIANA, spol. s.r.o., 160 00 Praha, Velflíkova 8",
      "dodavatel_ico":"49704362",
      "predmet":"letenka VIE-BRU-VIE Lauro",
      "sumasdph":690.01,
      "datum":"2017-11-13",
      "objednavka":"4200001515",
      "mena":"EUR"
   }
]

V prípade chyby

Vráti objekt s parametrom error s popisom chyby

• error - popis chyby

Príklad:

{
    "error":"Parameter 'customer' cannot be empty."
}

Návštevnosť stránky

Analytika návštevnosti webu

Metóda: GET

Prístup: /navstevnost/{datumOd}/{datumDo}/{granularita}/

Parametre

• {datumOd} - [povinné] dátum, od ktorého chceme údaje získať. Musí byť vo formáte YYYY-MM-DD
• {datumDo} - [povinné] dátum, do ktorého chceme údaje získať. Musí byť vo formáte YYYY-MM-DD
• {granularita} - [povinné] granularita údajov. Platné hodnoty: daily, weekly, monthly. Pre granularitu daily je povolený maximálny rozsah 120 dní. Pre granularity weekly a monthly je maximálny rozsah 400 dní.

Odpovede

Kód	Popis
200	Úspešná operácia
404	Nenájdené žiadne záznamy pre danú požiadavku

Formát odpovede

V prípade úspechu

Vráti pole dátových bodov podľa parametrov s údajmi o návštevnosti webu.

• pole dátových bodov
  • date - dátum pre dátový bod, v prípade ak je granularita údajov daily, je vo formáte YYYY-MM-DD. Pre weekly je vo formáte YYYY Ww, kde W je veľké písmeno W a w je poradové číslo týždňa v roku. Pre monthly je vo formáte YYYY-MM.
  • analytics - údaje analytiky
    • unique - unikátne návštevy podľa IP adresy
    • sessions - unikátne relácie
    • page_views - celkový počet zobrazených stránok

Príklad:

[
   {
      "date":"2021-07",
      "analytics":{
         "unique":1,
         "sessions":1,
         "page_views":1
      }
   },
   {
      "date":"2021-08",
      "analytics":{
         "unique":"0",
         "sessions":"0",
         "page_views":"0"
      }
   },
   {
      "date":"2021-09",
      "analytics":{
         "unique":2,
         "sessions":12,
         "page_views":256
      }
   }
]

V prípade chyby

Vráti objekt s parametrom error s popisom chyby

• error - popis chyby

Príklad:

{
    "error":"Invalid value of parameter 'granularity'. Valid values are: daily, weekly, monthly"
}

Zobrazenia článkov

Metóda: GET

Prístup: /clanky/{datumOd}/{datumDo}/

Parametre

• {datumOd} - [povinné] dátum, od ktorého chceme údaje získať. Musí byť vo formáte YYYY-MM-DD
• {datumDo} - [povinné] dátum, do ktorého chceme údaje získať. Musí byť vo formáte YYYY-MM-DD

Odpovede

Kód	Popis
200	Úspešná operácia
404	Nenájdené žiadne záznamy pre danú požiadavku

Formát odpovede

V prípade úspechu

Vráti pole článkov navštívených v danom období s informáciou o počte návštev za dané obdobie.

• pole článkov
  • page_url - URL adresa článku
  • views - Počet návštev / kliknutí na článok
  • title - Titulok článku

Príklad:

[
   {
      "page_url":"http:\/\/localhost\/aktuality\/890",
      "views":6,
      "title":"Vykonané aktivity implementácie manažérstva kvality partnermi projektu za mesiac apríl"
   },
   {
      "page_url":"http:\/\/localhost\/aktuality\/760",
      "views":1,
      "title":"StandarDays 2020"
   },
   {
      "page_url":"http:\/\/localhost\/aktuality\/841",
      "views":1,
      "title":"ÚNMS SR bezodplatne sprístupňuje TNI CWA 17553 Tvárové rúška pre verejnosť."
   }
]

V prípade chyby

Vráti objekt s parametrom error s popisom chyby

• error - popis chyby

Príklad:

{
    "error":"Parameter 'dateFrom' cannot be empty"
}

Zobrazenia podstránok

Metóda: GET

Prístup: /stranky/{datumOd}/{datumDo}/

Parametre

• {datumOd} - [povinné] dátum, od ktorého chceme údaje získať. Musí byť vo formáte YYYY-MM-DD
• {datumDo} - [povinné] dátum, do ktorého chceme údaje získať. Musí byť vo formáte YYYY-MM-DD

Odpovede

Kód	Popis
200	Úspešná operácia
404	Nenájdené žiadne záznamy pre danú požiadavku

Formát odpovede

V prípade úspechu

Vráti pole podstránok navštívených v danom období s informáciou o počte návštev za dané obdobie.

• pole podstránok
  • page_url - URL adresa podstránky
  • views - Počet návštev / kliknutí na podstránku
  • title - Titulok podstránky

Príklad:

[
   {
      "page_url":"http:\/\/localhost\/stranka\/37",
      "views":1,
      "title":"Cena Vladimíra Lista za normalizáciu za rok 2008"
   },
   {
      "page_url":"http:\/\/localhost\/stranka\/49",
      "views":1,
      "title":"Rokovanie pracovnej skupiny EHK OSN v Ženeve "
   }
]

V prípade chyby

Vráti objekt s parametrom error s popisom chyby

• error - popis chyby

Príklad:

{
    "error":"Parameter 'dateFrom' cannot be empty"
}

Normy a termíny

Terminologické vyhľadávanie

Metóda: GET

Prístup: /normy/{termín}/{typVyhľadávania}/{jazyk}/

Parametre

• {termín} - [povinné] vyhľadávaný termín
• {typVyhľadávania} - typ vyhľadávania. Platné hodnoty: default, and, or, norm. Typy vyhľadávania sú bližšie popísané nižšie
• {jazyk} - jazyk vyhľadávania. Platné hodnoty: sk, en. Obmedzí vyhľadávanie na termíny v danom jazyku.

Typy vyhľadávania

Kód	Popis
default	Fulltextové vyhľadávanie podľa zoradené podľa relevancie hľadaných výrazov. Umožňuje aj frázové vyhľadávanie vložením výrazu do úvodzoviek ("hľadaný výraz")
and	Vyhľadávanie podľa logickej funkcie AND (a zároveň) - bude vyhľadávať len v termínoch, ktoré obsahujú všetky zadané slová
or	Vyhľadávanie podľa logickej funkcie OR (alebo) - bude vyhľadávať v termínoch, ktoré obsahujú aspoň jedno zadané slovo
norm	Zadajte presné číslo normy, napr. STN EN 589

Odpovede

Kód	Popis
200	Úspešná operácia
404	Nenájdené žiadne záznamy pre danú požiadavku

Formát odpovede

V prípade úspechu

Vráti pole všetkých termínov a noriem vyhovujúcim parametrom.

• terms - pole termínov
  • kat_c - katalógové číslo normy, ku ktorej termín patrí
  • sk - informácie o termíne v slovenskom jazyku
    • term - znenie termínu
    • def - definácia termínu
    • note - poznámka k termínu
  • en - informácie o termíne v anglickom jazyku
    • term - znenie termínu
    • def - definácia termínu
    • note - poznámka k termínu
  • norm - informácie o norme
    • kat_c - katalógové číslo normy
    • norm - Označenie STN normy
    • nazov - názov normy
    • datum_vydania - dátum vydania vo formáte YYYY-MM-DD

Príklad:

{
  "terms": [
    {
      "kat_c": 124329,
      "sk": {
        "term": "testovanie",
        "def": "postup na hodnotenie; prostriedky na určovanie prítomnosti, kvality alebo správnosti niečoho",
        "note": ""
      },
      "en": {
        "term": "testing",
        "def": "",
        "note": ""
      },
      "norm": {
        "kat_c": 124329,
        "norma": "STN EN ISO 22301:2017",
        "nazov": "Ochrana spoločnosti. Systémy manažérstva plynulého podnikania. Požiadavky (ISO 22301: 2012)",
        "datum_vydania": "2017-04-01",
        "shop_link": "https://normy.unms.sk/eshop/public/standard_detail.aspx?id=124329"
      }
    },
    {
      "kat_c": 123420,
      "sk": {
        "term": "„scab-test“",
        "def": "urýchlená korózna skúška na vonkajšej stanici prerušovaná postrekom skúšobných vzoriek alebo predmetov roztokom chloridu sodného",
        "note": ""
      },
      "en": {
        "term": "scab-test",
        "def": "",
        "note": ""
      },
      "norm": {
        "kat_c": 123420,
        "norma": "STN EN ISO 8044:2016",
        "nazov": "Korózia kovov a zliatin. Základné termíny a definície (ISO 8044: 2015)",
        "datum_vydania": "2016-10-01",
        "shop_link": "https://normy.unms.sk/eshop/public/standard_detail.aspx?id=123420"
      }
    }
  ]
}

V prípade chyby

Vráti objekt s parametrom error s popisom chyby

• error - popis chyby

Príklad:

{
    "error":"No items found."
}

Typovky - Schválenia Typu Určených Meradiel

Zoznam všetkych certifikátov

Metóda: GET

Prístup: /typovky/{databáza}/

Parametre

• {databáza} - [povinné] databáza, ku ktorej položkám chceme prístup. Typovky sú rozdelené na 3 databázy, dve z nich historické

Databázy

Názov	Popis
tsq	Dokumenty vydané od 1. januára 1993 do 7. mája 1998 podľa zákona č. 505/1990 Zb. o metrológii.
cert	Dokumenty vydané od 8. mája 1998 do 30. júna 2000 podľa zákona č. 30/1968 Zb. o štátnom skúšobníctve.
tsk	Dokumenty vydané od 1. júla 2000 po súčasnosť podľa zákona č. 142/2000 Z. z. o metrológii a o zmene a doplnení niektorých zákonov v znení neskorších predpisov a následne podľa zákona č. 157/2018 Z. z. o metrológii a o zmene a doplnení niektorých zákonov.

Odpovede

Kód	Popis
200	Úspešná operácia
404	Nenájdené žiadne záznamy pre danú požiadavku

Formát odpovede

V prípade úspechu

Vráti pole všetkych certifikátov v danej databáze.

• certificates - pole termínov
  • id - ID položky
  • cislo - číslo certifikátu / číslo rozhodnutia
  • znacka_typu - Značka schváleného typu / Indetifikačné číslo meradla
  • odbor_merania
    • id - Číselné označenie odboru merania
    • name - Ľudsky čítateľné meno odboru merania
  • druh_dokumentu
    • alpha - Označenie druhu dokumentu
    • name - Ľudský čítateľné meno druhu dokumentu
  • datum_vydania - Dátum vydania rozhodnutie vo formáte YYYY-MM-DD
  • nazov_meradla - Názov meradla
  • typ_meradla - Typ meradla
  • vyrobca - Výrobca meradla
  • platnost_dokumentu - Platnosť dokumentu
  • cas_platnosti_overenia - Čas platnosti overenia
  • file - URL adresa so súborom rozhodnutia
  • poznamka - Poznámka k certifikátu / rozhodnutiu
  • prihlasovatel - Prihlasovateľ - Len pre databázu cert
  • ziadatel - Žiadateľ - Len pre databázy tsk a tsq
  • cislo_revizie - Číslo revízie - Len pre databázu tsk
  • cislo_dodatku - Číslo dodatku - Len pre databázu tsq

Príklad:

{
   "certificates":[
      {
         "id":418,
         "cislo":"C\/350169\/126\/142\/99-334",
         "znacka_typu":"142\/99-334",
         "odbor_merania":{
            "id":"142",
            "name":"vodomery, prietokomery ako členy meračov tepla"
         },
         "druh_dokumentu":{
            "alpha":"",
            "name":""
         },
         "datum_vydania":"1999-12-30",
         "nazov_meradla":"Vírový prietokomer",
         "typ_meradla":"Prowirl 77",
         "vyrobca":"Endress+Hauser Flowtec AG, Švajčiarsko",
         "platnost_dokumentu":"30.12.2009",
         "cas_platnosti_overenia":"6 rokov\/4 roky\/4 roky",
         "file":"https:\/\/www.unms.sk\/files\/typovky\/cert\/C_350169_126_142-99-334_566.pdf",
         "poznamka":"",
         "prihlasovatel":"Transcom Technik, spol. s r.o., SR"
      },
      {
         "id":417,
         "cislo":"350316\/126\/143\/00-152",
         "znacka_typu":"143\/00-152",
         "odbor_merania":{
            "id":"143",
            "name":"plynomery, prepočítavače objemu plynu"
         },
         "druh_dokumentu":{
            "alpha":"B",
            "name":"Rozhodnutie o schválení typu meradla"
         },
         "datum_vydania":"2000-05-23",
         "nazov_meradla":"Prepočítavač množstva plynu",
         "typ_meradla":"ELCOR-94",
         "vyrobca":"ELGAS, s.r.o., ČR",
         "platnost_dokumentu":"13.05.2006",
         "cas_platnosti_overenia":"5 rokov",
         "file":"https:\/\/www.unms.sk\/files\/typovky\/cert\/350316_126_143-00-152_565.pdf",
         "poznamka":"",
         "prihlasovatel":"SPP Servis, a.s., SR"
      }
   ]
}

V prípade chyby

Vráti objekt s parametrom error s popisom chyby

• error - popis chyby

Príklad:

{
    "error":"Invalid parameter 'database'."
}

Zoznam odborov meraní

Metóda: GET

Prístup: /typovkyOdbory/{databáza}/

Parametre

• {databáza} - [povinné] databáza, ku ktorej položkám chceme prístup. Typovky sú rozdelené na 3 databázy, dve z nich historické

Databázy

Názov	Popis
tsq	Dokumenty vydané od 1. januára 1993 do 7. mája 1998 podľa zákona č. 505/1990 Zb. o metrológii.
cert	Dokumenty vydané od 8. mája 1998 do 30. júna 2000 podľa zákona č. 30/1968 Zb. o štátnom skúšobníctve.
tsk	Dokumenty vydané od 1. júla 2000 po súčasnosť podľa zákona č. 142/2000 Z. z. o metrológii a o zmene a doplnení niektorých zákonov v znení neskorších predpisov a následne podľa zákona č. 157/2018 Z. z. o metrológii a o zmene a doplnení niektorých zákonov.

Odpovede

Kód	Popis
200	Úspešná operácia
404	Nenájdené žiadne záznamy pre danú požiadavku

Formát odpovede

V prípade úspechu

Vráti pole všetkych odborov platné pre danú databázu.

• odbory - pole odborov merania
  • id - Číslo označenia
  • name - Názov odboru

Príklad:

{
   "odbory":[
      {
         "id":111,
         "name":"dĺžkové meradlá"
      },
      {
         "id":116,
         "name":"taxametre"
      },
      {
         "id":121,
         "name":"závažie"
      }
   ]
}

V prípade chyby

Vráti objekt s parametrom error s popisom chyby

• error - popis chyby

Príklad:

{
    "error":"Invalid parameter 'database'."
}

Čítať certifikát podľa ID

Metóda: GET

Prístup: /typovky/{databáza}/{id}/

Parametre

• {databáza} - [povinné] databáza, ku ktorej položkám chceme prístup. Typovky sú rozdelené na 3 databázy, dve z nich historické
• {id} - [povinné] ID certifikátu v danej databáze

Databázy

Názov	Popis
tsq	Dokumenty vydané od 1. januára 1993 do 7. mája 1998 podľa zákona č. 505/1990 Zb. o metrológii.
cert	Dokumenty vydané od 8. mája 1998 do 30. júna 2000 podľa zákona č. 30/1968 Zb. o štátnom skúšobníctve.
tsk	Dokumenty vydané od 1. júla 2000 po súčasnosť podľa zákona č. 142/2000 Z. z. o metrológii a o zmene a doplnení niektorých zákonov v znení neskorších predpisov a následne podľa zákona č. 157/2018 Z. z. o metrológii a o zmene a doplnení niektorých zákonov.

Odpovede

Kód	Popis
200	Úspešná operácia
404	Nenájdené žiadne záznamy pre danú požiadavku

Formát odpovede

V prípade úspechu

Vráti objekt s detailami certifikátu.

• id - ID položky
• cislo - číslo certifikátu / číslo rozhodnutia
• znacka_typu - Značka schváleného typu / Indetifikačné číslo meradla
• odbor_merania
  • id - Číselné označenie odboru merania
  • name - Ľudsky čítateľné meno odboru merania
• druh_dokumentu
  • alpha - Označenie druhu dokumentu
  • name - Ľudský čítateľné meno druhu dokumentu
• datum_vydania - Dátum vydania rozhodnutie vo formáte YYYY-MM-DD
• nazov_meradla - Názov meradla
• typ_meradla - Typ meradla
• vyrobca - Výrobca meradla
• platnost_dokumentu - Platnosť dokumentu
• cas_platnosti_overenia - Čas platnosti overenia
• file - URL adresa so súborom rozhodnutia
• poznamka - Poznámka k certifikátu / rozhodnutiu
• prihlasovatel - Prihlasovateľ - Len pre databázu cert
• ziadatel - Žiadateľ - Len pre databázy tsk a tsq
• cislo_revizie - Číslo revízie - Len pre databázu tsk
• cislo_dodatku - Číslo dodatku - Len pre databázu tsq

Príklad:

{
   "id":1,
   "cislo":"C\/310005\/127\/128\/98-281",
   "znacka_typu":"128\/98-281",
   "odbor_merania":{
      "id":"128",
      "name":"elektronické váhy"
   },
   "druh_dokumentu":{
      "alpha":"B",
      "name":"Rozhodnutie o schválení typu meradla"
   },
   "datum_vydania":"1998-08-17",
   "nazov_meradla":"Elektromechanické váhy s neautomatickou činnosťou s elektronickou vyhodnocovacou jednotkou Mettler-Toledo, typ 8530",
   "typ_meradla":"TEN...",
   "vyrobca":"TENZONA, spol. s r.o., SR",
   "platnost_dokumentu":"18.08.2008",
   "cas_platnosti_overenia":"2 roky",
   "file":"https:\/\/www.unms.sk\/files\/typovky\/cert\/C_310005_127_128-98-281_1.pdf",
   "poznamka":"",
   "prihlasovatel":"TENZONA, spol. s r.o., SR"
}

V prípade chyby

Vráti objekt s parametrom error s popisom chyby

• error - popis chyby

Príklad:

{
    "error":"No items found."
}

Hľadať certifikáty

Metóda: GET

Prístup: /typovky/{databáza}/{searchType}/{searchTerm}/

Parametre

• {databáza} - [povinné] databáza, ku ktorej položkám chceme prístup. Typovky sú rozdelené na 3 databázy, dve z nich historické
• {searchType} - [povinné] Typ vyhľadávania, popísaný bližšie nižšie
• {searchTerm} - [povinné] Hľadaný výraz

Databázy

Názov	Popis
tsq	Dokumenty vydané od 1. januára 1993 do 7. mája 1998 podľa zákona č. 505/1990 Zb. o metrológii.
cert	Dokumenty vydané od 8. mája 1998 do 30. júna 2000 podľa zákona č. 30/1968 Zb. o štátnom skúšobníctve.
tsk	Dokumenty vydané od 1. júla 2000 po súčasnosť podľa zákona č. 142/2000 Z. z. o metrológii a o zmene a doplnení niektorých zákonov v znení neskorších predpisov a následne podľa zákona č. 157/2018 Z. z. o metrológii a o zmene a doplnení niektorých zákonov.

Typy vyhľadávania

Typ formátovania je reťazec obsahujúci aspoň jeden zo symbolov popísaných v tabuľke nižšie. Tieto symboly je možné kombinovať pre vyhľadávanie podľa viacerých kritérii. Symboly iné ako tie popísané nižšie budú ignorované a bude ignorovaný aj k nim priradený hľadný výraz.

Symbol	Popis
z	Vyhľadávanie podľa značky schváleného typu alebo identifikačného čísla meradla.
o	Vyhľadávanie podľa číselného označenia odboru merania.
t	Vyhľadávanie podľa typu meradla.
v	Vyhľadávanie podľa výrobcu meradla.

Hľadaný výraz

Formátovaný v poradí typov vyhľadávania oddelených bodkočiarkami ak hľadáme podľa viacerých premenných.

Napr. ak je typ vyhľadávania nastavený na ot, hľadaný výraz môže byť napríklad 116;Kienzle pre vyhľadávanie Taxametrov (odbor merania s označením 116) s typom meradla obsahujúcim reťazec Kienzle.

Celý dotaz by tak vyzeral /typovky/tsk/ot/116;Kienzle/

Odpovede

Kód	Popis
200	Úspešná operácia
404	Nenájdené žiadne záznamy pre danú požiadavku

Formát odpovede

V prípade úspechu

Vráti pole všetkych certifikátov v danej databáze.

• certificates - pole termínov
  • id - ID položky
  • cislo - číslo certifikátu / číslo rozhodnutia
  • znacka_typu - Značka schváleného typu / Indetifikačné číslo meradla
  • odbor_merania
    • id - Číselné označenie odboru merania
    • name - Ľudsky čítateľné meno odboru merania
  • druh_dokumentu
    • alpha - Označenie druhu dokumentu
    • name - Ľudský čítateľné meno druhu dokumentu
  • datum_vydania - Dátum vydania rozhodnutie vo formáte YYYY-MM-DD
  • nazov_meradla - Názov meradla
  • typ_meradla - Typ meradla
  • vyrobca - Výrobca meradla
  • platnost_dokumentu - Platnosť dokumentu
  • cas_platnosti_overenia - Čas platnosti overenia
  • file - URL adresa so súborom rozhodnutia
  • poznamka - Poznámka k certifikátu / rozhodnutiu
  • prihlasovatel - Prihlasovateľ - Len pre databázu cert
  • ziadatel - Žiadateľ - Len pre databázy tsk a tsq
  • cislo_revizie - Číslo revízie - Len pre databázu tsk
  • cislo_dodatku - Číslo dodatku - Len pre databázu tsq

Príklad:

{
   "certificates":[
      {
         "id":418,
         "cislo":"C\/350169\/126\/142\/99-334",
         "znacka_typu":"142\/99-334",
         "odbor_merania":{
            "id":"142",
            "name":"vodomery, prietokomery ako členy meračov tepla"
         },
         "druh_dokumentu":{
            "alpha":"",
            "name":""
         },
         "datum_vydania":"1999-12-30",
         "nazov_meradla":"Vírový prietokomer",
         "typ_meradla":"Prowirl 77",
         "vyrobca":"Endress+Hauser Flowtec AG, Švajčiarsko",
         "platnost_dokumentu":"30.12.2009",
         "cas_platnosti_overenia":"6 rokov\/4 roky\/4 roky",
         "file":"https:\/\/www.unms.sk\/files\/typovky\/cert\/C_350169_126_142-99-334_566.pdf",
         "poznamka":"",
         "prihlasovatel":"Transcom Technik, spol. s r.o., SR"
      },
      {
         "id":417,
         "cislo":"350316\/126\/143\/00-152",
         "znacka_typu":"143\/00-152",
         "odbor_merania":{
            "id":"143",
            "name":"plynomery, prepočítavače objemu plynu"
         },
         "druh_dokumentu":{
            "alpha":"B",
            "name":"Rozhodnutie o schválení typu meradla"
         },
         "datum_vydania":"2000-05-23",
         "nazov_meradla":"Prepočítavač množstva plynu",
         "typ_meradla":"ELCOR-94",
         "vyrobca":"ELGAS, s.r.o., ČR",
         "platnost_dokumentu":"13.05.2006",
         "cas_platnosti_overenia":"5 rokov",
         "file":"https:\/\/www.unms.sk\/files\/typovky\/cert\/350316_126_143-00-152_565.pdf",
         "poznamka":"",
         "prihlasovatel":"SPP Servis, a.s., SR"
      }
   ]
}

V prípade chyby

Vráti objekt s parametrom error s popisom chyby

• error - popis chyby

Príklad:

{
    "error":"Invalid parameter 'database'."
}