Un sito ufficiale dell'Unione europea
Angolo degli sviluppatori per i riutilizzatori
Aspetti generali
Il sito TED offre diverse interfacce per programmi applicativi (API).
Le API consentono di:
- cercare e recuperare i dati pubblicati sul portale TED (TED search API)
- scaricare avvisi in vari formati utilizzando link diretti
- scaricare in blocco avvisi e bandi in formato XML
- scaricare il calendario delle pubblicazioni.
Il sito TED offre anche feed RSS.
Dal 14 novembre 2022 gli avvisi e bandi disponibili sul sito TED utilizzano sia i formulari TED che quelli elettronici o eForms:
- i formulari elettronici figurano al regolamento (UE) 2019/1780 che introduce nuovi moduli standard per gli appalti pubblici (validi dal 14 novembre 2022)
- i formulari TED sono definiti dal regolamento (UE) 2015/1986 e si basano su uno standard di interoperabilità dell'Ufficio delle pubblicazioni.
Informazioni relative ad entrambi i formulari sono disponibili nella documentazione per sviluppatori TED
Cercare e recuperare i dati pubblicati sul portale TED (TED search API)
L'API di ricerca del sito TED è accessibile in forma anonima per consentire l'uso del motore di ricerca del sito per trovare avvisi o bandi di gara specifici.
La documentazione relativa all'API di ricerca TED è disponibile all'indirizzo: https://ted.europa.eu/api/documentation/index.html
Scaricare avvisi in vari formati utilizzando link diretti
È possibile scaricare un avviso o bando utilizzando un link diretto, in qualsiasi lingua ufficiale dell'UE e nei seguenti formati: HTML, download HTML, PDF firmato e non firmato.
Il formato degli URL del link diretto è il seguente:
https://ted.europa.eu/{lang}/notice/{publication-number}/{format}
dove:
- {lang} corrisponde alla lingua (ad es. en, de)
- {publication-number} è il numero di pubblicazione (ad es. 1-2024, 87654321-2024 )
- {format} può essere:
- html: per visualizzare il file di download HTML
- pdf: per scaricare l'avviso o bando in formato PDF
- pdfs: per scaricare l'avviso o bando in formato PDF firmato.
È inoltre possibile scaricare gli avvisi utilizzando un link diretto in formato XML.
Il formato degli URL del link diretto è il seguente:
https://ted.europa.eu/en/notice/{publication-number}/xml
Scaricare in blocco avvisi in formato XML
Dalla pagina Download in blocco dei file XML del sito TED è possibile scaricare in blocco dal portale TED gli avvisi in formato XML.
Un unico archivio (pacchetto XML) contiene tutti gli avvisi e bandi relativi al giorno o mese prescelto.
I pacchetti XML contengono file numerati in due modi:
- per i formulari elettronici, i file XML hanno 8 cifre seguite dall'anno (ad es. 00654321_2022.xml)
- per i formulari TED, i file XML hanno 6 cifre seguite dall'anno (ad es. 123456_2022.xml).
Il formato degli URL per scaricare i pacchetti è il seguente:
- formato URL per i pacchetti giornalieri:
https://ted.europa.eu/packages/notice/daily/{yyyynnnnn}
dove {yyyynnnnn} corrisponde al numero della GU S.
Esempio: per scaricare il pacchetto giornaliero della GU S 1/2024: https://ted.europa.eu/packages/daily/202400001
- formato URL per i pacchetti mensili:
https://ted.europa.eu/packages/notice/monthly/{yyyy-n}
dove {yyyy-n} corrisponde all'anno e al mese.
Esempio: per scaricare il pacchetto mensile del gennaio 2024: https://ted.europa.eu/packages/monthly/2024-1
Scaricare il calendario delle pubblicazioni
Dalla pagina Calendario delle pubblicazioni del sito TED è possibile scaricare l'elenco delle GU S pubblicate ogni anno.
Il formato degli URL per scaricare il calendario delle pubblicazioni è il seguente:
https://ted.europa.eu/{lang}/release-calendar/-/download/file/{format}/{year}
dove:
- {lang} corrisponde alla lingua (ad es. en, it)
- {format} può essere: XLS, PDF, CSV
- {year} corrisponde all'anno (ad es. 2023, 2024)
Esempio: https://ted.europa.eu/en/release-calendar/-/download/file/XLS/2024
Sottoinsiemi TED in formato CSV
Un sottoinsieme di dati TED relativi ai campi più importanti degli avvisi di gara e degli avvisi di aggiudicazione degli appalti in formato con campi separati da una virgola (CSV) è disponibile all'indirizzo data.europa.eu/data/datasets/ted-csv?locale=it.
Politica di uso corretto su TED
Operazione | Limiti |
Visualizzare o scaricare avvisi da un unico indirizzo IP | 600 visualizzazioni o download in meno di 6 minuti |
Richieste HTTP | 700 richieste nell'ultimo minuto |
Scaricare pacchetti giornalieri o mensili tramite il servizio HTTPS | 3 download simultanei |
L'architettura del portale TED è progettata nel modo seguente:
- le pagine web sono completamente supportate da un sistema di gestione dei contenuti (CMS) che consente un'esperienza utente migliore e personalizzata. Il CMS è efficiente in una gamma specifica di caricamenti
- un'API pubblica, efficiente e scalabile, permette di cercare gli avvisi e include un link diretto per scaricarne i contenuti.
Di conseguenza, l'Ufficio delle pubblicazioni raccomanda vivamente agli utenti tecnici di utilizzare l'API pubblica per beneficiare delle sue prestazioni e della sua scalabilità, lasciando le risorse del CMS a disposizione degli altri utenti.