Pre vývojárov

Úrad pre publikácie poskytuje niekoľko aplikačných programovacích rozhraní (API) pre webové stránky venované databáze TED a európskemu verejnému obstarávaniu.

Tieto rozhrania API vám umožňujú:

enlightenedUpozorňujeme, že hoci Úrad pre publikácie poskytuje prístup k týmto rozhraniam API, neposkytujeme technickú podporu pri ich používaní.

 

Všeobecné informácie

Naše registračné požiadavky a mechanizmy overovania týkajúce sa rozhraní API sa líšia v závislosti od využívania a predpokladaného publika. Podrobnejšie informácie nájdete v opisoch jednotlivých rozhraní API.

Naše rozhrania API sú v súlade so zásadami analogickými s REST a používajú štandardné kódy odozvy HTTP. Údaje v žiadostiach a odozvách sa nachádzajú v texte JSON. V prípade takmer všetkých rozhraní API poskytujeme štruktúrovaný opis za použitia špecifikácie vo formáte OpenAPI verzii 2.0 (známej aj ako „Swagger“).

Keď je obsah XML oznámenia zahrnutý do údajovej časti textu JSON, je zakódovaný v Base64 a zaobchádza sa s ním ako s reťazcom. Tým sa zabráni problémom so znakmi, ktoré majú v texte JSON osobitný význam (citáty, čiarky atď.).

Vytváranie verzií

Keď urobíme spätne nekompatibilnú zmenu, vytvoríme novú verziu. Táto verzia sa objaví na každej adrese URL, napríklad „/v2/...“.

Za spätne kompatibilné sa považujú tieto zmeny:

  • pridanie nových operácií API
  • pridanie nových nepovinných vstupných parametrov (v texte JSON alebo v reťazci dotazu) k existujúcim metódam API
  • pridanie nových vlastností textu JSON do existujúcich odpovedí API
  • zmena poradia vlastností v existujúcich odpovediach API.
Odporúčania pre implementáciu klienta

So zreteľom na opísanú politiku kompatibility sa pri implementácii klienta dbajte na to, aby sa akékoľvek neočakávané polia v odpovediach ignorovali. Nespoliehajte sa na poradie polí v texte JSON.

Každá požiadavka HTTP na naše API musí obsahovať záhlavie „User Agent“ (agent používateľa). Uveďte čo najpresnejšiu hodnotu pre toto záhlavie, pomôžete nám tým vyriešiť prípadné problémy.

 

Získanie uverejnených údajov

Opísané operácie môžete použiť bez registrácie alebo overenia.

Od 14. novembra 2022 budú oznámenia dostupné na webovom sídle TED v súlade s formulármi schém TED a elektronickými formulármi.

Formuláre schém TED sú stanovené v nariadení (EÚ) 2015/1986 a sú založené na norme interoperability Úradu pre publikácie. Dokumentácia je k dispozícii na webovom sídle Slovníky EÚ.

Elektronické formuláre sú stanovené v nariadení (EÚ) 2019/1780, ktorým sa zavádzajú nové štandardné formuláre pre obstarávanie Nariadenie o elektronických formulároch nadobúda účinnosť 14. novembra 2022. Elektronické formuláre sú založené na norme interoperability univerzálneho obchodného jazyka. Ďalšie informácie sú k dispozícii na príslušnej stránke SIMAP.

Ak oznámenia TED používate opakovane, musíte svoje systémy upraviť tak, aby podporovali nové oznámenia.

 
Vyhľadávanie a získavanie oznámení

Na vyhľadávanie oznámení o verejnom obstarávaní uverejnených na webovom sídle TED môžete použiť viacero rôznych kritérií. Tak môžete získať osobitné informácie týkajúce sa oznámení, ktoré budú zodpovedať vašim kritériám. Vyhľadávací dotaz sa používa pri expertnom vyhľadávaní.

Pomocou osobitnej operácie môžete získať aj informácie o počte oznámení za jednotlivé geografické oblasti (kód NUTS). Webové sídlo TED využíva tieto informácie na vytvorenie mapy „Miesto dodania“.

Podrobnosti nájdete v dokumentácii API.

Môžete si aj hromadne stiahnuť oznámenia vo formáte XML z webového sídla TED. Jeden archív obsahuje všetky oznámenia za jednotlivé dni aj mesiace.

Schémy XML používané v oznámeniach a príslušná dokumentácia sú dostupné na webovom sídle Slovníky EÚ.

Čiastkový súbor údajov z oznámení uverejnených na webovom sídle TED je k dispozícii aj vo formáte CSV (čiarkou oddelené hodnoty) ako súbor údajov na portáli data.europa.eu.

Zobraziť oznámenia v rôznych formátoch

Na základe obsahu oznámenia vo formáte XML môžete dostať oznámenie vo formáte HTML alebo PDF a v konkrétnom jazyku.

K dispozícii budú dve rôzne rozhrania API: jedno na zobrazenie oznámení vo forme schém TED a druhé na zobrazenie oznámení vo forme elektronických formulárov:

  • spôsob zobrazenia oznámení vo forme schém TED je opísaný v dokumentácii API TED Notice Viewer
  • ako zobraziť oznámenia vo forme elektronických formulárov bude opísané v dokumentácii TED eForms Notice Viewer
Uverejnené výzvy na predkladanie ponúk zo strany inštitúcií EÚ

Môžete získať zoznam výziev na predkladanie ponúk zo strany inštitúcií EÚ, ktoré sú uverejnené na webovom sídle elektronického zadávania zákaziek.

Zoznam, ktorý obsahuje základné informácie o jednotlivých výzvach, možno filtrovať podľa:

  • názvu verejného obstarávateľa,
  • stavu výzvy,
  • jazyka.

Podrobnosti nájdete v dokumentácii API vo formáte PDF.

 

Zaslať oznámenia na uverejnenie

Zabezpečujeme operácie, ktoré umožňujú verejným alebo súkromným subjektom – známym ako „TED eSenders“ – predkladať oznámenia na uverejnenie na webovom sídle TED prostredníctvom ich vlastných softvérových systémov. Pozri našu stránku o tom, ako získať status TED eSender.

Prístup k týmto operáciám sa obmedzuje na eSenders a na subjekty, ktoré požiadali o udelenie statusu eSender. Autentifikácia sa vykonáva prostredníctvom systému „Basic“ zabezpečeného prostredníctvom HTTPS.

Podrobné informácie o operáciách týkajúcich sa eSenders, ktorí chcú predkladať oznámenia na uverejnenie na webovom sídle TED, sú uvedené v dokumentácii eSentool Production API.

Rovnaké operácie zabezpečujeme aj na 2 ďalších koncových bodoch s cieľom poskytnúť podporu pre uchádzačov o status eSender:

  • pri simulácii uverejňovania oznámení na webovom sídle TED s použitím eSentool Simulation API s príslušnou dokumentáciou API.
  • aby mohli splniť podmienky na uverejňovanie oznámení na webovom sídle TED s použitím eSentool Qualification API s príslušnou dokumentáciou API.

 

Integrácia do postupu verejného obstarávania

Zabezpečujeme rôzne operácie, ktoré umožňujú integrovať naše aplikácie do rozsiahlejšieho postupu verejného obstarávania vrátane:

  • vytvorenia alebo aktualizácie návrhu oznámenia v systéme eNotices
  • získania informácií o oznámení počas zverejnenia
  • určenia počtu slov a znakov v oznámení.

K týmto operáciám majú v súčasnosti prístup len inštitúcie EÚ. K dispozícii sú rôzne mechanizmy autentifikácie.

Podrobnosti nájdete v dokumentácii API.