Couvertures de livres - API BnF

Mise à jour suite à publication

À la suite de la publication de cette page, Aude Le Moullec-Rieu qui travaille à la diffusion des données aux communautés professionnelles à la BnF a posté le tweet suivant :

Ce qui est décrit dans le github est l'API utilisée par les applis de la BnF pour récupérer les couvertures. Une version publique de cette API est prévue pour 2021 : nouveaux critères de recherche, accessible dans une console swagger avec la nouvelle version du portail

Dès 2021 la BnF proposera donc un service du type de celui décrit ci-dessous, très bonne nouvelle donc. Je laisse en ligne cette page dans le cas où elle pourrait intéresser quelqu'un sur le principe (mise en place d'un proxy Symfony faisant appel à un serveur SRU puis récupérant des images et ajoutant un bandeau sur l'origine du document à l'image), mais la preuve de concept décrite ci-dessous n'a plus vraiment lieu d'être !

Contexte

En 2016, à l'occasion de l'organisation d'un hackathon, la BnF a mis en ligne une documentation de son API "couverture" qui permet de récupérer des couvertures d'ouvrage.

L'inconvénient principal de cette API réside dans l'obligation pour l'utiliser, de passer en paramètre un ARK qui est spécifique à la BnF. L'applicatif proposé ici se propose de faire une passerelle avec un identifiant plus standard, l'ISBN.

La question des jaquettes dans les catalogues de bibliothèque

L'enrichissement des catalogues de bibliothèques par l'utilisation de couvertures d'ouvrages est une question qui se pose de longue date, plusieurs offres existent, qu'elles soient payantes (Electre, Zebris, ...) ou gratuites avec contrepartie (Amazon, Google Books).

Aucune offre publique n'a (à ma connaissance) jamais vu le jour, et ce qui s'en rapproche le plus à l'heure actuelle est l'API que la BnF décrit sur Github.

Si la BnF décrit cette API sur Github, je n'ai pas réussi à trouver d'information officielle de la BnF concernant la possibilité offerte à une bibliothèque de l'utiliser pour enrichir son propre catalogue.

Depuis janvier 2014 la BnF met à disposition sous licence ouverte les notices qu'elle produit, mais rien n'est dit pour ces images. Si la BnF n'est bien entendu pas titulaire des droits d'auteur sur ces illustrations, dispose-t-elle d'une autorisation de distribution, ce point n'est pas précisé.

Le service proposé ici ajoute en bas des couvertures une mention indiquant l'origine de l'image et propose une preuve de concept, mais pour une mise en oeuvre en situation réelle, il conviendrait bien entendu de préciser cet aspect légal.

Preuve de concept

Afin de valider la faisabilité de l'utilisation de l'API couverture de la BnF par une institution tierce, une API web a été développée dont le code est disponible sur Github.

Cette application est développée en PHP/mysql sur la base du framework Symfony. Cette preuve de concept implémente les fonctionnalités suivantes :

Plusieurs fonctionnalités seraient à revoir dans le cadre d'une mise en oeuvre réelle de l'outil :

Utilisation

Le code disponible sur Github est installé sur ce serveur pour en valider le principe fonctionnel.

L'url de base pour appeler l'API est la suivante :
https://couverture.geobib.fr/api/v1/_isbn_/_size_

_size_ peut prendre l'une des valeurs suivantes :

Exemple

Exemple de l'appel pour l'image

https://couverture.geobib.fr/api/v1/978-2-36279-267-0/small

couverture de l'ouvrave 978-2-36279-267-0

Voir la même image :

Informations complémentaires

Si besoin de me contacter vous trouverez mon adresse sur cette page, vous pouvez aussi me trouver sur twitter

Page mise en ligne le 26 avril 2020 par Sylvain Machefert.