Introduction

L’API DataCite permet d’accéder aux métadonnées des ressources scientifiques, jeux de données, logiciels et publications disposant d’un DOI attribué par DataCite. Cette API ouverte facilite la recherche, l’analyse et l’intégration de données FAIR (Findable, Accessible, Interoperable, Reusable) dans vos applications, portails ou outils de veille scientifique.

Fonctionnalités Clés

• Recherche avancée de ressources par titre, auteur, DOI, ORCID, type, sujet, etc.
• Accès aux métadonnées complètes (auteurs, affiliations, licence, liens, etc.).
• Filtrage par type de ressource, date, langue, éditeur, etc.
• API RESTful, pagination, tri et sélection de champs.
• Pas d’authentification requise pour la consultation publique.

Ressources de l’API

Principaux Paramètres

• query : recherche plein texte
• page[size] : nombre de résultats par page (max 1000)
• page[number] : numéro de page
• filter : filtrage avancé (ex : resource-type-id:dataset, published:2024)
• sort : tri des résultats (ex : relevance, created)
• fields : sélection des champs retournés

Exemples d’Implémentation

• Requête cURL
• Python
• JavaScript (fetch)

# Rechercher des jeux de données publiés en 2024 sur le climat
curl "https://api.datacite.org/dois?query=climat&filter=resource-type-id:dataset,published:2024&page[size]=3"
                

import requests

url = "https://api.datacite.org/dois"
params = {
    "query": "biodiversité",
    "page[size]": 2,
    "filter": "resource-type-id:dataset"
}

response = requests.get(url, params=params)
if response.status_code == 200:
    data = response.json()
    for item in data["data"]:
        print(item["attributes"]["titles"][0]["title"])
else:
    print("Erreur:", response.status_code)
                

// Récupérer les derniers DOI d’un entrepôt DataCite
fetch("https://api.datacite.org/dois?client-id=datacite.ris&sort=created&page[size]=2")
  .then(res => res.json())
  .then(data => {
    data.data.forEach(item => console.log(item.attributes.titles[0].title));
  });
                

Bonnes Pratiques

• Limiter la taille des pages pour éviter des réponses trop volumineuses.
• Utiliser les filtres pour cibler précisément vos recherches.
• Respecter la pagination pour l’intégration de grands volumes de données.
• Consulter la documentation officielle pour les dernières évolutions.

Conclusion

L’API DataCite est un outil essentiel pour accéder, valoriser et intégrer les ressources scientifiques et jeux de données FAIR. Sa simplicité d’utilisation, sa richesse fonctionnelle et sa compatibilité avec les standards internationaux en font un atout pour chercheurs, institutions et développeurs.