För utvecklare

Publikationsbyrån har flera programmeringsgränssnitt (API:er) som gäller för TED och offentlig upphandling i EU.

Med de här API:erna kan du

ikon för glödlampa Vi tillhandahåller bara de här API:erna och har ingen teknisk support för användarna.

 

Allmän information

Registreringskraven och autentiseringsmekanismerna för våra API:er varierar beroende på användning och målgrupp. Du kan läsa mer i beskrivningarna av de olika API:erna.

Våra API:er följer Rest-liknande principer och använder de vanliga http-svarskoderna. Datan i frågor och svar är i Json. För nästan alla API:er har vi en strukturerad beskrivning som bygger på OpenAPI specification version 2.0 (också kallad ”Swagger”).

När ett meddelandes xml-innehåll ingår i en Json-nyttolast kodas den i Base64 och hanteras som en sträng. På så sätt undviker man alla problem med tecken som har en specifik innebörd i Json (t.ex. citat-och kommatecken.)

Versionshantering

Vi skapar en ny version om vi gör en ändring som inte är kompatibel bakåt. Den nya versionen framgår av URL:en, t.ex. ”/v2/...”.

Följande ändringar anses vara kompatibla bakåt:

  • Tillägg av nya API-åtgärder.
  • Tillägg av nya frivilliga inputparametrar (i Json eller i frågesträngen) till befintliga API-metoder.
  • Tillägg av nya Json-egenskaper till befintliga API-svar.
  • Ändring av ordningsföljden för egenskaper i befintliga API-svar.
Rekommendationer för klientimplementering

Med tanke på den kompatibilitetspolicy som beskrivs ovan är det viktigt att tänka på att eventuella oväntade fält i svaren ignoreras när man inför en klient. Lita inte på fältens ordning i Json.

Alla http-förfrågningar till våra API:er måste innehålla rubriken ”användaragent”. Specificera värdet för den här rubriken så noggrant som möjligt för att hjälpa oss att utreda potentiella problem.

 

Hämta publicerade data

Du kan använda de åtgärder som beskrivs här utan registrering eller autentisering.

Från den 14 november 2022 kommer meddelandena på TED-webbplatsen att följa både TED-schemaformulären och e-formulären.

TED-schemaformulären fastställs i förordning (EU) 2015/1986 och bygger på Publikationsbyråns standard för interoperabilitet. Dokumentationen finns på webbplatsen för EU-vokabulärer.

E-formulären fastställs i förordning (EU) 2019/1780 om införande av nya standardformulär för upphandling, som träder i kraft den 14 november 2022. De bygger på standarden UBL, universal business langauage. Läs mer om e-formulär och offentlig upphandling

Om du vidareutnyttjar TED-meddelanden måste du anpassa dina system så att de kan hantera de nya meddelandena.

 
Söka och hämta meddelanden

Du kan använda ett antal olika kriterier för att söka efter upphandlingsmeddelanden som publiceras på TED-webbplatsen, och hämta specifik information för meddelanden som motsvarar dina kriterier. Sökfrågan är samma som används för expertsökningen.

Du kan också få antalet meddelanden för varje geografiskt område (NUTS-koder) med hjälp av en specifik åtgärd. TED-webbplatsen använder den här informationen för att skapa en karta över ”leveransplatser”.

Läs mer i API-dokumentationen.

Du kan också hämta xml-meddelanden i större volymer från TED. Ett enda arkiv innehåller alla meddelanden per dag och månad.

De xml-scheman som används för meddelanden och tillhörande dokumentation finns på webbplatsen för EU-vokabulärer.

En delmängd med uppgifter från de meddelanden som publiceras på TED-webbplatsen finns också som csv (”kommaseparerade värden”) i form av datamängder på EU:s portal för öppna data.

Se meddelanden i olika format

Utifrån innehållet i ett meddelande i xml kan du få meddelandet i html- eller pdf-format och på ett visst språk.

Det kommer att finnas två olika API:n för att visa meddelanden – ett för TED-scheman och ett för e-formulär:

Publicerade upphandlingar från EU-institutionerna

Du kan få en lista med EU-institutionernas upphandlingar i den form de publicerats på webbplatsen eTendering.

Listan innehåller basinformation om varje upphandling och kan filtreras på

  • den upphandlande myndighetens namn
  • upphandlingens status
  • språk.

Läs mer i API-dokumentationen i pdf.

 

Skicka meddelanden för publicering

Vi har åtgärder som gör det möjligt för offentliga och privata organ – TED:s så kallade ”eSenders” – att skicka meddelanden för publicering på TED via sina egna mjukvarusystem. Läs mer på vår sida om hur man blir en eSender för TED.

Det är bara en eSender och den som har ansökt om att få bli en eSender som har tillgång till de här åtgärderna. Autentiseringen görs via ”basschemat” med säker anslutning via https.

Läs mer om åtgärder för eSender för att skicka meddelanden för publicering på TED-webbplatsen i dokumentationen om eSentools produktions-API.

Vi kan också tillhandahålla samma åtgärder i två andra slutpunkter för att stödja processen för dem som ansöker om att bli eSender:

  • För att simulera publiceringar av meddelanden på TED kan man använda eSentools simulerings-API med tillhörande API-dokumentation
  • För att bli behörig att publicera meddelanden på TED kan man använda eSentools behörighets-API med tillhörande API-dokumentation

 

Integrering i upphandlingsprocessen

Vi har olika åtgärder för att integrera våra applikationer i den bredare upphandlingsprocessen, t.ex. för att

  • skapa eller uppdatera utkast till meddelanden i eNotices
  • få information om ett meddelande under publiceringen
  • avgöra antalet ord eller tecken i ett meddelande.

Just nu är det bara EU-institutionerna som har tillgång till de här åtgärderna. Det finns olika autentiseringsmekanismer.

Läs mer i API-dokumentationen.