En naviguant sur notre site vous acceptez l'installation et l'utilisation des cookies sur votre ordinateur. En savoir +

Menu Logo Principal

Datapartage

Utiliser l'API DOI Inra

L’offre de service DOI comporte une API REST qui permet aux systèmes d'information INRA d’attribuer des DOI aux données qu'ils gèrent.

Pour accéder aux ressources de cette API, il faut disposer d'une autorisation (login et mot de passe) à demander à doi@versailles.inra.fr

Fonctionnalités de l’API :

  • Générer un numéro de DOI spécifique à l’Inra (préfixe 10.475)
  • Activer un DOI, c'est à dire déclarer auprès de DataCite le numéro précédemment généré, en indiquant :
    • le numéro de DOI,
    • l’URL de la landing page décrivant le jeu de données identifié par le DOI (l’URL doit appartenir au domaine inra.fr),
    • un fichier de métadonnées compatible avec les versions 4.0 ou 3.1 du schéma DataCite.

Le login utilisé pour déclarer le DOI est enregistré et peut seul modifier les informations associées à ce DOI.

  • Modifier les métadonnées ou l’URL de la landing page ou des médias associés à un DOI déclaré dans DataCite.
    Seul le login utilisé pour déclarer le DOI est autorisé à modifier ces informations.
  • Obtenir les métadonnées (au format xml) ou l’URL de la landing page ou des médias associés à un DOI déclaré dans DataCite.

Ressources REST disponibles

  • /doi-canonical
    pour l'obtention d'un identifiant de DOI, la déclaration d'un DOI auprès de DataCite, la mise à jour de l'URL de la landing page associée à un DOI, et la récupération de la landing page associée à un DOI
  • /doi-metadata
    pour la récupération, la mise à jour et la suppression des métadonnées associées à un DOI
  • /doi-media
    pour la récupération et la mise à jour de la liste des médias et urls associées correspondant à un DOI

Url d'accès aux ressources

Préproduction

  • https://api.data-preproduction.inra.fr/doi/v1/doi-canonical
  • https://api.data-preproduction.inra.fr/doi/v1/doi-metadata
  • https://api.data-preproduction.inra.fr/doi/v1/doi-media

Production

  • https://api.data.inra.fr/doi/v1/doi-canonical
  • https://api.data.inra.fr/doi/v1/doi-metadata
  • https://api.data.inra.fr/doi/v1/doi-media

La documentation des ressources de l'API est disponible sur le catalogue des API (onglet "Console de l'API").