Le coin des développeurs

L’Office des publications fournit un certain nombre d’interfaces de programmation d’applications web (API) liées à TED et aux marchés publics européens.

Ces API vous permettent:

enlightened Veuillez noter que l’Office des publications fournit un accès à ces API, mais pas d’assistance technique pour leur utilisation.

Informations générales

Les exigences d’enregistrement et les mécanismes d’authentification de nos API varient en fonction de l’usage et du public visé. Veuillez consulter la description de chaque API pour en savoir plus.

Nos API suivent les principes REST et utilisent les codes de réponse HTTP standards. Les données des demandes et des réponses sont au format JSON. Pour presque toutes les API, nous fournissons une description structurée à l’aide de la spécification OpenAPI («Swagger»), version 2.0.

Lorsque le contenu XML d’un avis est inclus dans une charge utile JSON, il est encodé en Base64 et traité comme une chaîne de caractères. Cela évite tout problème avec des caractères ayant une signification spécifique dans JSON (citations, virgules, etc.).

Versions

Lorsque nous procédons à une modification qui n’est pas rétrocompatible, nous créons une nouvelle version. L’indication de la nouvelle version figure dans chaque URL («/v2/...», par exemple).

Les modifications suivantes sont considérées comme rétrocompatibles:

  • ajout de nouvelles opérations API;
  • ajout de nouveaux paramètres d’entrée facultatifs (dans JSON ou dans la chaîne de recherche) aux méthodes API existantes;
  • ajout de nouvelles propriétés JSON aux réponses API existantes;
  • modification de l’ordre des propriétés dans les réponses API existantes.

La section Dernières nouvelles ci-dessous décrit les dernières modifications apportées à nos API.

Recommandations pour la mise en place d'un client

Compte tenu de la politique de compatibilité décrite ci-dessus, assurez-vous, lors de la mise en place d’un client, que les champs non prévus dans les réponses sont ignorés. N’utilisez pas l’ordre des champs dans JSON.

Chaque requête HTTP doit contenir l’en-tête «User-Agent». Veuillez préciser la valeur de cet en-tête de manière aussi précise que possible pour nous aider à examiner les problèmes potentiels.

Obtenir des données publiées

Vous pouvez recourir aux opérations décrites ici sans enregistrement ni authentification.

Rechercher et extraire des avis

Vous pouvez utiliser différents critères pour rechercher les avis de marché publiés sur le site web TED et extraire des informations spécifiques pour les avis correspondant à vos critères. La requête de recherche est celle utilisée pour la recherche en mode expert.

Vous pouvez également obtenir le nombre d’avis par zone géographique (code NUTS) par une opération spécifique. Le site web TED utilise ces informations pour créer la carte «Lieu de livraison».

Pour en savoir plus, voir la documentation API.

Vous pouvez aussi télécharger en bloc des avis au format XML à partir du site TED. Une archive unique contient tous les avis publiés chaque jour et chaque mois.

Les schémas XML utilisés pour les avis et la documentation correspondante sont disponibles sur le site web EU Vocabularies.

Un sous-ensemble de données provenant des avis publiés sur le site web TED est également disponible au format CSV (valeurs séparées par des virgules) en tant que jeu de données sur le portail des données ouvertes de l’UE.

Voir les avis dans différents formats

À partir du contenu d’un avis au format XML, vous pouvez obtenir l’avis en HTML ou PDF, dans une langue spécifique.

Pour en savoir plus, voir la documentation API.

Appels d’offres publiés par des institutions de l’UE

Vous pouvez obtenir une liste des appels d’offres des institutions de l’UE, tels qu’ils sont publiés sur le site web eTendering.

Cette liste, qui fournit les principales informations sur chaque appel, peut être filtrée par:

  • nom du pouvoir adjudicateur;
  • statut de l’appel;
  • langue.

Pour en savoir plus, voir la documentation API.

Envoyer des avis pour publication

Nous fournissons les opérations permettant aux organismes publics ou privés de soumettre des avis pour publication sur le site web de TED par l’intermédiaire de leurs propres logiciels. Ils deviennent alors des «TED eSenders». Voir notre page sur Comment devenir un TED eSender.

L’accès à ces opérations est réservé aux eSenders et aux organismes qui ont demandé à le devenir. L’authentification est assurée par le système d’authentification basique, sécurisé par le protocole HTTPS.

Voir la documentation sur l’API eSentool Production pour en savoir plus sur les opérations permettant aux eSenders de soumettre des avis pour publication sur le site web TED.

Nous fournissons les mêmes opérations sur deux autres points d’entrée permettant aux candidats eSender:

  • de simuler la publication d’avis sur le site web TED, en utilisant l’API eSentool Simulation, à l’aide de la documentation API correspondante;
  • de se qualifier pour publier sur le site web TED, en utilisant l’API eSentool Qualification, à l’aide de la documentation API correspondante.

Intégration dans la procédure de passation de marchés

Nous fournissons plusieurs opérations permettant à nos applications de s’intégrer dans le processus de passation de marchés, notamment:

  • créer ou mettre à jour un projet d’avis dans eNotices;
  • obtenir des informations sur un avis durant sa publication;
  • déterminer le nombre de mots et de caractères dans un avis.

Seules les institutions de l’UE ont actuellement accès à ces opérations. Différents mécanismes d’authentification sont disponibles.

Pour en savoir plus, voir la documentation API.

Dernières nouvelles

15/9/2019: nouvelle version de l’API de recherche du site TED

Une nouvelle version de l’API de recherche du site TED est désormais disponible (préfixe d’URL «https://ted.europa.eu/api/v2.0»). Cette nouvelle version était nécessaire pour introduire certaines modifications non rétrocompatibles.

Modifications

  • Les opérations sous «/api/latest» ont été supprimées.
  • La clé API n’est plus nécessaire.
  • Les champs «ND» et «OJ» dans les résultats de recherche sont désormais indiqués comme une chaîne de caractères (et non comme un nombre entier), reflétant leur contenu réel.

Améliorations

  • Nouvelle opération permettant d’extraire le nombre d’avis par zone géographique (code NUTS).
  • Plusieurs améliorations de la documentation «OpenAPI».