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"