Espaço dos criadores

O Serviço das Publicações disponibiliza uma série de interfaces de programação de aplicações Web (API) relacionadas com o TED e a contratação pública europeia.

Estas API permitem:

enlightened  Nota: embora o Serviço das Publicações dê acesso a estas API, não presta apoio técnico à sua utilização.

Informações gerais

Os requisitos de registo e os mecanismos de autenticação das API variam em função da utilização e do público a que se destinam. Para mais informações, consulte as descrições das diferentes API.

As nossas API seguem princípios de tipo REST e usam códigos de resposta HTTP normalizados. Os dados dos pedidos e das respostas estão no formato JSON. Disponibilizamos uma descrição estruturada de quase todas as API, utilizando a versão 2.0 da especificação OpenAPI (também conhecida por «Swagger»).

Se o conteúdo XML de um anúncio for incluído num payload JSON, é codificado em Base64 e tratado como uma cadeia de carateres. Evitam-se, assim, eventuais problemas com carateres que tenham um significado específico em JSON (aspas, vírgulas, etc.).

Versões

Sempre que introduzimos alterações incompatíveis com versões anteriores, criamos uma nova versão. A versão é indicada no URL, por exemplo, «/v2/...».

As seguintes alterações são consideradas compatíveis com versões anteriores:

  • aditamento de novas operações API
  • aditamento de novos parâmetros de entrada facultativos (em JSON ou na cadeia de consulta) a métodos API existentes
  • aditamento de novas propriedades JSON a respostas API existentes
  • alteração da ordem das propriedades em respostas API existentes

A secção Novidades descreve todas as alterações recentemente introduzidas nas nossas API.

Recomendações para a implementação de clientes

Tendo em conta a política de compatibilidade acima descrita, ao implementar um cliente, deve certificar-se de que qualquer campo imprevisto das respostas é ignorado. Não use a ordem dos campos no JSON.

Cada pedido HTTP às API deve conter o cabeçalho «User-Agent». Deve especificar o valor deste cabeçalho com a maior exatidão possível para nos ajudar a detetar eventuais problemas.

Obter dados publicados

Pode usar as operações descritas a seguir sem precisar de se registar ou autenticar.

Procurar e obter anúncios

Pode utilizar vários critérios para procurar anúncios de concurso publicados no sítio TED e obter informações específicas dos anúncios correspondentes aos seus critérios. A consulta de pesquisa é a usada para a pesquisa profissional.

Também pode obter o número de anúncios para uma determinada área geográfica (código NUTS) através de uma operação específica. O sítio TED utiliza estas informações para criar o mapa «Local de entrega».

Para mais informações, consulte a documentação API.

Pode ainda descarregar em massa de anúncios no formato XML a partir do sítio TED. Todos os anúncios por dia e por mês estão contidos num arquivo único.

Os esquemas XML usados nos anúncios e na documentação correspondente estão disponíveis no sítio EU Vocabularies.

Um subconjunto de dados provenientes de anúncios publicados no sítio TED está igualmente disponível num ficheiro CSV (valores separados por vírgulas) no Portal de Dados Abertos da UE.

Visualizar anúncios em diferentes formatos

Com base no conteúdo de um anúncio em XML, pode obter o anúncio no formato HTML ou PDF e numa língua específica.

Para mais informações, consulte a documentação API.

Concursos públicos publicados pelas instituições europeias

Pode obter uma lista dos concursos das instituições europeias, conforme publicados no sítio eTendering.

Esta lista contém informações gerais sobre cada concurso e pode ser filtrada por:

  • nome da entidade adjudicante
  • estatuto do concurso
  • língua

Para mais informações, consulte a documentação API.

Enviar anúncios para publicação

Graças às operações que disponibilizamos, as entidades públicas ou privadas – as chamadas «eSenders» – podem enviar anúncios para publicação no sítio TED através dos seus próprios sistemas informáticos. Consulte a nossa página Como ser um TED eSender.

O acesso a estas operações está limitado aos eSenders e às entidades candidatas a tornar-se eSender. A autenticação processa-se através do esquema «Basic», protegido por HTTPS.

Para mais informações sobre as operações que permitem aos eSenders enviar anúncios para publicação no sítio TED, consulte a documentação eSentool Production API.

Disponibilizamos também as mesmas operações em dois outros pontos finais para apoiar o processo para as entidades candidatas a tornar-se eSender:

  • para simularem a publicação de anúncios no sítio TED, utilizando a eSentool Simulation API, com a documentação correspondente.
  • para se qualificarem para publicar anúncios no sítio TED, utilizando eSentool Qualification API, com a documentação correspondente

Integração no processo de contratação

Disponibilizamos várias operações que permitem integrar as nossas aplicações no processo de contratação pública, designadamente:

  • criação ou atualização de um projeto de anúncio no eNotices
  • obtenção de informações sobre um anúncio durante a publicação
  • determinação do número de palavras e dos carateres num anúncio

Atualmente, estas operações só estão disponíveis para as instituições europeias. Existem vários mecanismos de autenticação.

Para mais informações, consulte a documentação API.

Novidades

15/9/2019: Nova versão da API de pesquisa do sítio TED

Uma nova versão da API de pesquisa do sítio TED está disponível com o prefixo de URL «https://ted.europa.eu/api/v2.0». A nova versão foi necessária na sequência da introdução de alterações incompatíveis com versões anteriores.

Alterações

  • As operações em «/api/latest» foram suprimidas.
  • A chave API deixa de ser necessária.
  • Os campos «ND» e «OJ» nos resultados da pesquisa deixam de ser indicados sob a forma de número inteiro e passam a ser indicados sob a forma de cadeia de carateres, refletindo o seu conteúdo real.

Melhoramentos

  • Nova operação que permite obter o número de anúncios para uma determinada área geográfica (código NUTS).
  • Vários melhoramentos na documentação OpenAPI.