Moissonnage des métadonnées et diffusion des contenus

Moissonage OAI

DOAB permet aux bibliothèques et aux agrégateurs d’utiliser les métadonnées de tous les titres disponibles dans le répertoire des livres Open Access. Les métadonnées sont disponibles dans les formats suivants:

MARC21 métadonnées fournies par Penn State University Libraries

Penn State University Libraries fournit des notices MARC21 créées à partir des métadonnées fournies par la DOAB. Il y a trois fichiers :

  • Titres sous licence CC
  • Titres en lecture libre
  • Titres pour lesquels seul un nombre limité de chapitres est disponible dans le DOAB.

Téléchargez les données ici : https://dx.doi.org/10.26207/jdfm-n376

OAI PMH harvesting

L’URL de base pour la récolte OAI-PMH est https://directory.doabooks.org/oai/

(Exemple: https://directory.doabooks.org/oai/request?verb=ListMetadataFormats)

Il existe plusieurs formats de métadonnées. Le format xoai répertorie tous les champs de métadonnées, voir https://directory.doabooks.org/oai/request?verb=ListRecords&metadataPrefix=xoai.

(Exemple: https://directory.doabooks.org/oai/request?verb=GetRecord&identifier=oai:doabooks.org:20.500.12854/26303&metadataPrefix=xoai)

Flux RSS et Atom

Tous les flux de métadonnées sont disponibles gratuitement CC0 1.0 license.

Rechercher DOAB à l’aide d’une API REST

Syntaxe de recherche

Vous pouvez rechercher DOAB à l’aide d’une API REST, en utilisant la syntaxe suivante: https://directory.doabooks.org/rest/search?query=[search query]

Exemples:

  • Requête en texte intégral: “water AND fire” - https://directory.doabooks.org/rest/search?query=%22water+AND+fire%22
  • Requête utilisant dc.title: “The deliverance of open access books” - https://directory.doabooks.org/rest/search?query=dc.title:%22the+deliverance+of+open+access+books%22
  • Requête utilisant HANDLE: “20.500.12854/26303” - https://directory.doabooks.org/rest/search?query=handle:%2220.500.12854/26303%22

Répertorier toutes les métadonnées disponibles

Pour répertorier toutes les métadonnées disponibles, utilisez:

https://directory.doabooks.org/rest/search?query=[search query]&expand=metadata

Exemples:

  • Requête en texte intégral: “water AND fire” - https://directory.doabooks.org/rest/search?query=%22water+AND+fire%22&expand=metadata
  • Requête utilisant dc.title: “The deliverance of open access books” - https://directory.doabooks.org/rest/search?query=dc.title:%22the+deliverance+of+open+access+books%22&expand=metadata
  • Requête utilisant HANDLE: “20.500.12854/26303” - https://directory.doabooks.org/rest/search?query=handle:%2220.500.12854/26303%22&expand=metadata

Lister tous les objets de flux binaire disponibles

Pour répertorier tous les objets bitstream disponibles, utilisez:

https://directory.doabooks.org/rest/search?query=[search query]&expand=bitstreams

Exemples:

  • Requête en texte intégral: “water AND fire” - https://directory.doabooks.org/rest/search?query=%22water+AND+fire%22&expand=bitstreams
  • Requête utilisant dc.title: “The deliverance of open access books” - https://directory.doabooks.org/rest/search?query=dc.title:%22the+deliverance+of+open+access+books%22&expand=bitstreams
  • Requête utilisant HANDLE: “20.500.12854/26303” - https://directory.doabooks.org/rest/search?query=handle:%2220.500.12854/26303%22&expand=bitstreams

Répertorier toutes les métadonnées et objets de flux binaire disponibles

Pour répertorier à la fois les métadonnées et les objets bitstream, utilisez:

https://directory.doabooks.org/rest/search?query=[search query]&expand=metadata,bitstreams

Exemples:

  • Requête en texte intégral: “water AND fire” - https://directory.doabooks.org/rest/search?query=%22water+AND+fire%22&expand=metadata,bitstreams
  • Requête utilisant dc.title: “The deliverance of open access books” - https://directory.doabooks.org/rest/search?query=dc.title:%22the+deliverance+of+open+access+books%22&expand=metadata,bitstreams
  • Requête utilisant HANDLE: “20.500.12854/26303” - https://directory.doabooks.org/rest/search?query=handle:%2220.500.12854/26303%22&expand=metadata,bitstreams

Sélection des champs pour votre requête

Pour savoir quel champ de métadonnées utiliser:

  • Sélectionnez dans l’interface utilisateur Web un élément qui correspond à un résultat possible de votre requête
  • Ouvrez sa vue complète à l’aide de l’une de ces options: cliquez sur le lien “Afficher l’enregistrement de l’élément complet” sous la vignette ou ajoutez ?show=full to the item’s URL
  • Sélectionnez les champs de métadonnées et leur valeur correspondante.

Pour les champs de date, il est préférable d’ajouter le suffixe “_dt” après le nom du champ, par exemple dc.date.issued_dt si vous souhaitez que le filtre se comporte comme une date et non comme du texte.

Exemples:

  • Tous les titres, ajoutés la semaine dernière. Requête utilisant dc.date.accessioned_dt - https://directory.doabooks.org/rest/search?query=dc.date.accessioned_dt:[NOW-7DAY/DAY+TO+NOW]
  • Tous les titres, classés comme «Politique et gouvernement», ont été ajoutés la semaine dernière. Requête utilisant dc.subject.classification, dc.date.accessioned_dt - https://directory.doabooks.org/rest/search?query=dc.subject.classification:%22Politics+%26+Government%22+AND+dc.date.accessioned_dt:[NOW-7DAY/DAY+TO+NOW]
  • Tous les titres, ajoutés entre le 1er mai 2020 et le 10 mai 2020. Requête utilisant dc.date.accessioned_dt https://directory.doabooks.org/rest/search?query=dc.date.accessioned_dt:[2020-05-01T00:00:00Z+TO+2020-05-10T23:59:59Z]
  • Trouvez le titre le plus récemment ajouté, classé comme «Politique et gouvernement». Requête utilisant dc.subject.classification, dc.date.accessioned_dt - https://directory.doabooks.org/rest/search?query=dc.subject.classification:%22Politics+%26+Government%22&sort=dc.date.accessioned_dt&limit=1

Si nécessaire, vous pouvez développer les métadonnées, les flux binaires ou les deux.

Les collections

Si vous souhaitez exposer des collections, interrogez le champ oapen.collection (en utilisant l’étiquette de collection, pas un ID). Les mêmes options d’extension sont disponibles.

Exemple:

  • Retrouvez la collection “European Research Council” - https://directory.doabooks.org/rest/search?query=oapen.collection:%22European+Research+Council%22

Bailleurs de fonds

La récupération de toutes les publications par un bailleur de fonds peut être réalisée via les champs de métadonnées de relation. Pour trouver l’ID réel d’un bailleur de fonds, recherchez par nom de bailleur de fonds, en utilisant le champ du nom du donateur.

Exemple:

  • Trouvez le bailleur de fonds “Austrian Science Fund (FWF)“ - https://directory.doabooks.org/rest/search?query=grantor.name:Austrian+Science+Fund+%28FWF%29&expand=metadata
  • L’ID peut être trouvé avec la balise <UUID>: <UUID>a39fc2ba-9538-4bcd-965c-6702ff320840</UUID>

Exposez les publications en interrogeant le champ oapen.relation.isFundedBy

Exemple:

  • L’identifiant du bailleur de fonds Austrian Science Fund est a39fc2ba-9538-4bcd-965c-6702ff320840 - https://directory.doabooks.org/rest/search?query=oapen.relation.isFundedBy:%22a39fc2ba-9538-4bcd-965c-6702ff320840%22

Si nécessaire, vous pouvez développer les métadonnées, les flux binaires ou les deux.

Notez que l’interrogation de grantor.name répertorie également toutes les publications financées par ce bailleur de fonds - sous le champ répété «oapen.relation.funds» - sans les détails. Par conséquent, utilisez la requête ci-dessus pour obtenir tous les détails à la fois au lieu d’utiliser une requête par élément pour obtenir leurs métadonnées / fichiers détaillés.

Éditeurs

La récupération de toutes les publications d’un éditeur peut être réalisée via les champs de métadonnées de relation. Pour trouver l’ID réel d’un éditeur, recherchez par nom d’éditeur, en utilisant le champ publisher.name.

Exemple:

  • Trouvez le éditeur “Oxford University Press” - https://library.oapen.org/rest/search?query=publisher.name:Oxford+University+Press&expand=metadata
  • L’ID peut être trouvé avec la balise ``<UUID> : <UUID>b9501915-cdee-4f2a-8030-9c0b187854b2</UUID>

Exposez les publications, en interrogeant le champ oapen.relation.isPublishedBy

Exemple:

  • L’ID de l’éditeur Oxford University Press est b9501915-cdee-4f2a-8030-9c0b187854b2 - https://library.oapen.org/rest/search?query=oapen.relation.isPublishedBy:%22b9501915-cdee-4f2a-8030-9c0b187854b2%22

Si nécessaire, vous pouvez développer les métadonnées, les flux binaires ou les deux.

Notez que l’interrogation de publisher.name liste également toutes les publications de cet éditeur - sous le champ répété “oapen.relation.isPublisherOf” - sans les détails. Par conséquent, utilisez la requête ci-dessus pour obtenir tous les détails en une seule fois au lieu d’utiliser une requête par élément pour obtenir leurs métadonnées / fichiers détaillés.

Communautés et collections

Le contenu du DOAB est divisé en «communautés», et les communautés sont subdivisées en «collections».

  • Lister toutes les communautés - https://directory.doabooks.org/rest/communities/
  • Lister toutes les collections - https://directory.doabooks.org/rest/collections/

Format XML ou JSON

Vous devez définir la propriété “Accept” de votre en-tête de requête sur JSON (application/json) ou XML (application/xml), selon le format avec lequel vous préférez travailler. 

Exemple:

  • Format JSON - curl -s -H "Accept : application/json" "https://directory.doabooks.org/rest/search?query=handle:%2220.500.12854/26303%22&expand=metadata,bitstreams"
  • Format XML - curl -s -H "Accept : application/xml" "https://directory.doabooks.org/rest/search?query=handle:%2220.500.12854/26303%22&expand=metadata,bitstreams"

API PRISM

Pour rechercher des entités peer review, vous pouvez utiliser ce point de terminaison sur l’application Web DSpace REST: directory.doabooks.org/rest/peerReviews.

Ce point de terminaison nécessite UN des paramètres de recherche suivants pour effectuer une recherche:

  • pId; Publisher legacy ID d’un éditeur associé à un élément contenant des informations de révision par les pairs; Publisher UUID d’un éditeur qui a été attaché à un élément contenant des informations peer review.
  • isbn: ISBN lié à un élément contenant des informations peer review.
  • doi: DOI d’un élément contenant des informations peer review.
  • title: nom d’un éditeur pouvant contenir plusieurs évaluations par les pairs liées à l’éditeur.

Le point de terminaison ne prend en charge qu’un seul paramètre de recherche à la fois. Si zéro ou plus d’un paramètre est fourni, une réponse d’erreur (état 400) sera affichée.

En fonction de la requête, une ou plusieurs entités peer review seront renvoyées. Lorsqu’aucun résultat n’a pu être trouvé pour une requête, une réponse d’erreur contenant l’état 404 s’affiche.

Exemple de requête: recherchez un livre en utilisant son DOI: https://directory.doabooks.org/rest/peerReviews?doi=10.3998/tfcp.13240726.0001.001