Le coin des développeurs

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

Ces API vous permettent:

enlightenedVeuillez noter que l’Office des publications fournit l’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, version 2.0 («Swagger»).

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.
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.

À partir du 14 novembre 2022, les avis disponibles sur le site TED seront conformes aux formulaires de schéma et formulaires électroniques TED.

Les formulaires de schéma TED sont définis dans le règlement (UE) 2015/1986 et reposent sur une norme d’interopérabilité de l’Office des publications. Une documentation est disponible sur le site web EU Vocabularies.

Les formulaires électroniques sont établis par le règlement (UE) 2019/1780 introduisant de nouveaux formulaires types pour la passation de marchés publics. Le règlement sur les formulaires électroniques entre en vigueur le 14 novembre 2022. Ces formulaires reposent sur la norme d’interopérabilité UBL (Universal Business Language). De plus amples informations sont disponibles sur la page SIMAP consacrée à ce sujet.

Si vous réutilisez des avis TED, vous devez adapter vos systèmes pour qu’ils prennent en charge les nouveaux avis.

 
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 sur l’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 data.europa.eu.

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.

Deux API différentes seront disponibles, l’une pour visualiser les avis de schéma TED et l’autre pour visualiser les formulaires électroniques:

  • les modalités de visualisation des avis de schéma TED sont décrites dans la documentation relative à l’API TED Notice Viewer;
  • les modalités de visualisation des formulaires électroniques seront décrites dans la documentation relative au TED eForms Notice Viewer.
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 sur l’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 sur l’API correspondante;
  • de se qualifier pour publier sur le site web TED, en utilisant l’API eSentool Qualification, à l’aide de la documentation sur l’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 sur l’API.