Základná URL

Základná URL pre API je https://www.uvostat.sk/api

Koncové body

GET <base_url>/ukoncene_obstaravania

Získa informácie o ukončených obstarávaniach. Parametre požiadavky:

• id[]: Voliteľné. ID ukončených obstarávaní, ktoré chcete získať. Ak nie je zadané, API vráti všetky obstarávania.
• obstaravatel_id[]: Voliteľné. ID obstarávateľov, ktorých obstarávania chcete získať. Ak nie je zadané, API vráti obstarávania všetkých obstarávateľov.
• datum_zverejnenia_od: Voliteľné. Dátum, od ktorého chcete získať obstarávania. Ak nie je zadané, API vráti obstarávania zverejnené od 1.1.2000.
• datum_zverejnenia_do: Voliteľné. Dátum, do ktorého chcete získať obstarávania. Ak nie je zadané, API vráti obstarávania zverejnené do dnešného dňa.
• cpv: Voliteľné. CPV kódy obstarávaní, ktoré chcete získať. Ak nie je zadané, API vráti obstarávania pre všetky CPV kódy.
• limit: Voliteľné. Maximálny počet obstarávaní, ktoré chcete získať. Ak nie je zadané, API vráti maximálne 100 obstarávaní.
• offset: Voliteľné. Počet obstarávaní, ktoré chcete preskočiť. Ak nie je zadané, API vráti obstarávania od prvého záznamu.

GET <base_url>/vyhlasene_obstaravania

Získa informácie o vyhlásených obstarávaniach. Parametre požiadavky:

• id[]: Voliteľné. ID ukončených obstarávaní, ktoré chcete získať. Ak nie je zadané, API vráti všetky obstarávania.
• obstaravatel_id[]: Voliteľné. ID obstarávateľov, ktorých obstarávania chcete získať. Ak nie je zadané, API vráti obstarávania všetkých obstarávateľov.
• datum_zverejnenia_od: Voliteľné. Dátum, od ktorého chcete získať obstarávania. Ak nie je zadané, API vráti obstarávania zverejnené od 1.1.2000.
• datum_zverejnenia_do: Voliteľné. Dátum, do ktorého chcete získať obstarávania. Ak nie je zadané, API vráti obstarávania zverejnené do dnešného dňa.
• cpv: Voliteľné. CPV kódy obstarávaní, ktoré chcete získať. Ak nie je zadané, API vráti obstarávania pre všetky CPV kódy.
• limit: Voliteľné. Maximálny počet obstarávaní, ktoré chcete získať. Ak nie je zadané, API vráti maximálne 100 obstarávaní.
• offset: Voliteľné. Počet obstarávaní, ktoré chcete preskočiť. Ak nie je zadané, API vráti obstarávania od prvého záznamu.

GET <base_url>/obstaravatelia

Získa informácie o obstarávateľoch. Parametre požiadavky:

• id[]: Voliteľné. ID obstarávateľov, ktorých informácie chcete získať. Ak nie je zadané, API vráti informácie o všetkých obstarávateľoch.
• ico[]: Voliteľné. IČO obstarávateľov, ktorých informácie chcete získať. Ak nie je zadané, API vráti informácie o obstarávateľoch s akýmkoľvek IČO.
• limit: Voliteľné. Maximálny počet záznamov, ktoré chcete získať. Ak nie je zadané, API vráti maximálne 100 záznamov.
• offset: Voliteľné. Počet záznamov, ktoré chcete preskočiť. Ak nie je zadané, API vráti zoznam obstarávateľov od prvého záznamu.

GET <base_url>/dodavatelia

Získa informácie o dodávateľoch. Parametre požiadavky:

• id[]: Voliteľné. ID dodávateľov, ktorých informácie chcete získať. Ak nie je zadané, API vráti informácie o všetkých dodávateľoch.
• ico[]: Voliteľné. IČO dodávateľov, ktorých informácie chcete získať. Ak nie je zadané, API vráti informácie o dodávateľoch s akýmkoľvek IČO.
• limit: Voliteľné. Maximálny počet záznamov, ktoré chcete získať. Ak nie je zadané, API vráti maximálne 100 záznamov.
• offset: Voliteľné. Počet záznamov, ktoré chcete preskočiť. Ak nie je zadané, API vráti zoznam dodávateľov od prvého záznamu.

GET <base_url>/crz_zmluvy

Získa informácie o CRZ zmluvách. Parametre požiadavky:

• objednavatel_ico[]: Voliteľné. IČO objednávateľov, ktorých zmluvy chcete získať. Ak nie je zadané, API vráti zmluvy objednávateľov s akýmkoľvek IČO.
• dodavatel_ico[]: Voliteľné. IČO dodávateľov, ktorých zmluvy chcete získať. Ak nie je zadané, API vráti zmluvy dodávateľov s akýmkoľvek IČO.
• datum_zverejnenia_od: Voliteľné. Dátum, od ktorého chcete získať zmluvy. Ak nie je zadané, API vráti zmluvy zverejnené od 1.1.2000.
• datum_zverejnenia_do: Voliteľné. Dátum, do ktorého chcete získať zmluvy. Ak nie je zadané, API vráti zmluvy zverejnené do dnešného dňa.
• limit: Voliteľné. Maximálny počet záznamov, ktoré chcete získať. Ak nie je zadané, API vráti maximálne 100 záznamov.
• offset: Voliteľné. Počet záznamov, ktoré chcete preskočiť. Ak nie je zadané, API vráti zoznam zmlúv od prvého záznamu.

Hlavičky

Všetky koncové body vyžadujú hlavičku ApiToken pre autentizáciu. Ak je token neplatný alebo nie je poskytnutý, odpoveď bude 401 Unauthorized.

Odpoveď

Odpoveď na všetky koncové body je objekt JSON s dvoma poliami:

• summary: Sumár požiadavky, vrátane celkového počtu záznamov, počtu vrátených záznamov, offsetu, limitu a poradia.
• data: Pole záznamov. Polia v každom zázname závisia od konkrétneho koncového bodu.

Chyby

Ak počas spracovania požiadavky nastane chyba, API vráti kód stavu HTTP spolu s objektom JSON obsahujúcim pole error s popisom chyby.

curl -X GET '<base_url>/api/ukoncene_obstaravania?id[]=1,2&obstaravatel_id[]=1,2,3&cpv[]=73000000-2,45214100-1&datum_zverejnenia_od=2023-01-01&datum_zverejnenia_do=2023-12-31&limit=50&offset=0' \
     -H 'ApiToken: <api_token>'

require 'net/http'
require 'uri'

uri = URI.parse("<base_url>/api/ukoncene_obstaravania")
params = {
  "id[]" => ["1", "2"],
  "obstaravatel_id[]" => ["1"],
  "cpv[]" => ["73000000-2,45214100-1"],
  "datum_zverejnenia_od" => "2023-01-01",
  "datum_zverejnenia_do" => "2023-12-31",
  "limit" => "50",
  "offset" => "0"
}
uri.query = URI.encode_www_form(params)

http = Net::HTTP.new(uri.host, uri.port)
request = Net::HTTP::Get.new(uri.request_uri)
request["ApiToken"] = "<api_token>"

response = http.request(request)

puts response.body

import requests

headers = {
    'ApiToken': '<api_token>',
}

params = (
    ('id[]', ['1', '2']),
    ('obstaravatel_id[]', ['1']),
    ('cpv[]', ['73000000-2,45214100-1']),
    ('datum_zverejnenia_od', '2023-01-01'),
    ('datum_zverejnenia_do', '2023-12-31'),
    ('limit', '50'),
    ('offset', '0'),
)

response = requests.get('<base_url>/api/ukoncene_obstaravania', headers=headers, params=params)

print(response.json())

<?php

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, '<base_url>/api/ukoncene_obstaravania?id[]=1,2&obstaravatel_id[]=1&cpv[]=73000000-2,45214100-1&datum_zverejnenia_od=2023-01-01&datum_zverejnenia_do=2023-12-31&limit=50&offset=0');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$headers = array();
$headers[] = 'ApiToken: <api_token>';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

?>