Desarrolladores

La Oficina de Publicaciones ofrece una serie de interfaces de programación de aplicaciones (API) relacionadas con TED y con la contratación pública europea.

Las API permiten:

enlightened  Nota: la Oficina de Publicaciones facilita el acceso a estas API, pero no ofrece apoyo técnico sobre su utilización.

Información general

Los requisitos de registro y los mecanismos de autenticación de las API varían según la utilización y el público destinatario. Para más detalles, consulte la descripción de cada API.

Nuestras API se basan en principios de tipo REST y utilizan los códigos estándar de respuesta HTTP. Los datos de los pedidos y las respuestas están en formato JSON. Para casi todas las API, ofrecemos una descripción estructurada que utiliza la especificación OpenAPI versión 2.0.

Cuando el contenido XML de un anuncio está incluido en una carga útil JSON, se codifica en Base64 y se trata como una cadena. Así se evitan problemas debidos a caracteres que tienen significados específicos en JSON (comillas, comas, etc.)

Versioneado

Cuando introducimos un cambio no retrocompatible, creamos una nueva versión. La versión aparece en cada URL; por ejemplo "/v2/...".

Los siguientes cambios se consideran retrocompatibles:

  • añadir nuevas operaciones de la API
  • añadir nuevos parámetros opcionales de entrada (en JSON o en la cadena de búsqueda) a métodos API existentes
  • añadir nuevas propiedades JSON a las respuestas API existentes
  • cambiar el orden de las propiedades en respuestas API existentes

Más abajo, en la sección de Últimas noticias, se describen los cambios más recientes en nuestras API.

Recomendaciones para las implementaciones de clientes

Dada la política de compatibilidad anteriormente descrita, al implementar un cliente, le rogamos compruebe que se ignora cualquier campo inesperado en las respuestas. No se base en el orden de los campos en JSON.

Toda petición HTTP a nuestras API debe contener el encabezado "User-Agent". Para ayudarnos a investigar posibles problemas, rogamos especifique el valor de este encabezado con la mayor precisión posible.

Obtener datos publicados

Es posible utilizar las operaciones aquí descritas sin registro ni autenticación.

Buscar y recuperar anuncios

Pueden utilizarse distintos criterios para buscar anuncios de licitación publicados en la web de TED y obtener información específica sobre los anuncios correspondientes a dichos criterios. Para ello se utiliza la búsqueda experta.

Una operación específica permite obtener el número de anuncios por zona geográfica (código NUTS). La web de TED utiliza esta información para crear el mapa del lugar de entrega.

Para más información, véase la documentación API.

También puede descargar en masa los anuncios en formato XML a partir de la web de TED. Cada archivo contiene todos los anuncios de cada día y cada mes.

Los esquemas XML utilizados para los anuncios y la documentación correspondiente están disponibles en la web de Vocabularios de la UE.

También está disponible en formato CSV (valores separados por comas) un subconjunto de datos de los anuncios publicados en la web de TED como conjunto de datos en el Portal de Datos Abiertos de la UE.

Ver los anuncios en varios formatos

A partir de un anuncio en formato XML, es posible obtenerlo en formato HTML o PDF y en un determinado idioma.

Para más información, véase la documentación API.

Convocatorias publicadas por las instituciones de la UE

Es posible obtener una lista de convocatorias publicadas por las instituciones de la UE en eTendering.

La lista ofrece información básica sobre cada convocatoria y puede filtrarse por:

  • nombre del poder adjudicador
  • estado de la convocatoria
  • lengua.

Para más información, véase la documentación API en formato PDF.

Enviar anuncios a publicación

Ofrecemos operaciones que permiten a organismos públicos o privados ("eSenders") enviar anuncios para su publicación en la web de TED a través de sus propios sistemas informáticos. Consulte nuestra página sobre cómo convertirse en eSender.

El acceso a estas operaciones está restringido a los eSenders y a quienes hayan solicitado convertirse en eSenders. La autenticación se efectúa a través del sistema "básico", de forma segura mediante HTTPS.

Para más detalles sobre las operaciones que permiten a los eSenders enviar anuncios para su publicación en la web de TED, consulte la documentación de la API eSentool Production.

Para apoyar a los candidatos en el proceso eSender, ofrecemos las mismas operaciones en otros dos puntos finales:

Integración en el proceso de licitación

Ofrecemos una serie de operaciones que permiten integrar nuestras aplicaciones en el proceso de contratación pública en general, tales como:

  • crear o actualizar un borrador de anuncio en eNotices
  • obtener información sobre un anuncio durante su publicación
  • determinar el número de palabras y caracteres de un anuncio.

En la actualidad, solo las instituciones de la UE tienen acceso a estas operaciones. Existen varios mecanismos de autenticación.

Para más información, véase la documentación API.

Últimas noticias

15/09/2019: Nueva versión de la API de búsqueda en la web de TED

Está disponible una nueva versión de la API de búsqueda en la web TED en la dirección https://ted.europa.eu/api/v2.0. Esta nueva versión era necesaria debido a que tuvimos que introducir una serie de cambios no retrocompatibles.

Cambios

  • Se han eliminado operaciones en "api/recents".
  • La clave API ya no es necesaria.
  • Los campos "ND" y "OJ" en los resultados de búsqueda aparecen ahora en forma de cadena (en lugar de un número entero), lo que refleja su contenido real.

Mejoras

  • Nueva operación para recuperar el número de anuncios por zona geográfica (código NUTS).
  • Diversas mejoras en la documentación OpenAPI.