Oficjalna strona internetowa Unii Europejskiej

Kącik programisty dla użytkowników

Informacje ogólne

W serwisie TED dostępnych jest szereg interfejsów programowania aplikacji (API).

Te interfejsy API umożliwiają:

  • wyszukiwanie i pobieranie danych opublikowanych w serwisie TED (API wyszukiwarki TED)
  • pobieranie ogłoszeń w różnych formatach za pomocą bezpośrednich linków
  • pobieranie ogłoszeń w formacie XML zbiorczo
  • pobieranie kalendarza wydań.


Serwis TED udostępnia również kanały RSS.


Od 14 listopada 2022 r. ogłoszenia dostępne w serwisie TED wykorzystują zarówno e-formularze, jak i formularze w schemacie TED:

  • E-formularze określono w rozporządzeniu (UE) 2019/1780 wprowadzającym nowe standardowe formularze zamówień publicznych (ważne od 14 listopada 2022 r.).
  • Formularze w schemacie TED określono w rozporządzeniu (UE) 2015/1986. Opierają się one na standardzie interoperacyjności Urzędu Publikacji.


Informacje o e-formularzach oraz formularzach w schemacie TED są dostępne w rubryce TED Developer Docs.

Wyszukiwanie i pobieranie danych opublikowanych w serwisie TED (API wyszukiwarki TED)

Do API wyszukiwarki TED można uzyskać dostęp anonimowo. Można wtedy korzystać z wyszukiwarki serwisu w celu znalezienia konkretnych ogłoszeń o zamówieniach.
Dokumentacja API wyszukiwarki TED jest dostępna na stronie https://ted.europa.eu/api/documentation/index.html

Pobieranie ogłoszeń w różnych formatach za pomocą bezpośrednich linków

Ogłoszenie można pobrać za pomocą bezpośredniego linku, w dowolnym języku urzędowym UE i w następujących formatach: HTML, HTML download, podpisany plik PDF o niepodpisany plik PDF.


Format URL bezpośredniego linku jest następujący:


https://ted.europa.eu/{lang}/notice/{publication-number}/{format}


gdzie:

  • {lang} oznacza język (np. en, de)
  • {publication-number} oznacza numer publikacji (np. 1-2024, 87654321-2024 )
  • {format} może być jednym z następujących formatów:
  • html: do wyświetlenia pliku HTML do pobrania
  • pdf: do pobrania ogłoszenia w wersji PDF
  • pdfs: do pobrania ogłoszenia w podpisanej wersji PDF

 

Ponadto można pobierać ogłoszenia za pomocą bezpośredniego linku w formacie XML.

Format URL bezpośredniego linku jest następujący:

https://ted.europa.eu/en/notice/{publication-number}/xml

Pobieranie ogłoszeń w formacie XML zbiorczo

Można pobrać ogłoszenia w formacie XML zbiorczo z serwisu TED za pośrednictwem strony Zbiorowe pobieranie XML.


Pojedyncze archiwum (pakiet XML) zawiera wszystkie ogłoszenia dla wybranego dnia i miesiąca.


Pakiety XML zawierają pliki XML ponumerowane na dwa sposoby:

  • w przypadku ogłoszeń w e-formularzach pliki XML mają 8 cyfr (np. 00654321_2022.xml)
  • w przypadku ogłoszeń w e-formularzach pliki XML mają 6 cyfr, po których następuje rok (np. 123456_2022.Xml)


Format URL do pobierania pakietów jest następujący:

  • Format URL dla pakietów codziennych:

https://ted.europa.eu/packages/notice/daily/{yyyynnnnn}

przy czym {yyyynnnnn} oznacza numer D.U. S.


Przykład – Pobierz pakiet codzienny Dz.U. S 1 / 2024: https://ted.europa.eu/packages/daily/202400001

  • Format URL dla pakietów miesięcznych:

https://ted.europa.eu/packages/notice/monthly/{yyyy-n}

przy czym {yyyy-n} oznacza rok i miesiąc.

Przykład – Pobierz pakiet miesięczny ze stycznia 2024 r.: https://ted.europa.eu/packages/monthly/2024-1

Pobieranie kalendarza wydań

Można pobrać listę wydań Dz.U. S rocznie za pośrednictwem strony Kalendarz wydań w serwisie TED.


Format URL do pobierania kalendarza wydań jest następujący:

https://ted.europa.eu/{lang}/release-calendar/-/download/file/{format}/{year}

przy czym:

  • {lang} oznacza język (np. en, de)
  • {format} może to być jeden z następujących formatów: XLS, PDF, CSV
  • {year} oznacza rok (np. 2023, 2024)


Przykład: https://ted.europa.eu/en/release-calendar/-/download/file/XLS/2024

Podzbiory TED w formacie CSV

Podzbiór danych TED obejmujący najważniejsze pola z ogłoszeń o zamówieniu i ogłoszeń o udzieleniu zamówienia w formacie rozdzielanym przecinkami (CSV) jest dostępny pod adresem data.europa.eu/data/datasets/ted-csv?locale=pl.

Zasady optymalnego korzystania z portalu TED

Operacja Limity
Wyświetlanie lub pobieranie ogłoszeń z jednego adresu IP 600 wyświetleń lub pobrań w czasie krótszym niż 6 minut
Żądania HTTP 700 żądań w ciągu ostatniej minuty
Pobieranie dziennych lub miesięcznych pakietów za pomocą usługi HTTPS 3 jednoczesne pobrania

 

Architektura portalu TED została zaprojektowana w następujący sposób:

– Strony internetowe w pełni opierają się systemie zarządzania treścią CMS, co umożliwia lepsze dostosowane do potrzeb użytkowników. CMS jest wydajny przy określonym zakresie obciążeń.

– Specjalny publiczny interfejs API, który jest wydajny i skalowalny, może być wykorzystywany do wyszukiwania ogłoszeń i zawiera bezpośredni link do pobierania ich treści.

Dlatego, aby optymalnie wykorzystać wydajność i skalowalność, użytkownicy techniczni powinni korzystać z publicznego interfejsu API, a zwykli użytkownicy z zasobów CMS.