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.