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:

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)

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.

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/

API: Peer review

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.11647/OBP.0197