kézako Bibliosurf
Bibliosurf

Présentation de l’API 100% littérature de Bibliosurf

votre catalogue connecté à ce que dit le web


Description de l’API

Il est proposé de récupérer la veille de Bibliosurf sur des sites et des catalogues distants.

Les données suivantes sont récupérables :
 revue du web
 podcast
 vidéo.

L’API permet de récupérer les données liées :
 aux livres en grand format
 aux livres numériques PNB
 aux auteurs
 au logiciel de recommandation.
 à l’animation de catalogue

L’API a été refondue avec 4 objectifs :

 contrôler l’accès à l’API
 éviter la surcharge de la base de données
 permettre la récupération des données en plusieurs formats
 ouvrir les accès aux catalogues des bibliothèques et des librairies.

Les données sont récupérables en format html et json-ld.


Accès

Il est demandé à l’utilisateur de signaler son intention d’utiliser l’API via le formulaire de contact. En retour, il sera communiqué un identifiant . Pour tester l’API, vous pouvez utiliser l’identifiant 8.

L’API est ouverte aux bibliothèques, aux librairies et aux blogueurs.
L’accès à l’API est gratuit dans le cadre d’une utilisation non commerciale d’un particulier.


Récupération des données d’un livre

Pour récupérer les données liées à un livre, il convient d’utiliser l’EAN et d’ajouter le format dans lequel vous souhaitez récupérer ces données.
 api_html = html
 api_json= json-ld

Exemple pour un livre papier en grand format
https://www.bibliosurf.com/?page=api_ean&id={identifiant}&ean={ean13}&gabarit=api_html

L’API renvoie 3 types d’info :
 EANinvalid si l’EAN ne fait pas 13 chiffres
 EANnotfound si l’EAN n’a pas été trouvé dans la base
 la page HTML ou le flux json de données si l’EAN a été trouvé dans la base.

Pour récupérer les données liées à un livre PNB, il convient de procéder comme ainsi

https://www.bibliosurf.com/?page=api_pnb&id={identifiant}&ean={ean13}&gabarit=pnb_html


Récupération des données d’un auteur

Pour récupérer les données liées à un auteur, il convient d’utiliser l’ISNI. Le format de récupération est le json-ld.

Exemple
https://www.bibliosurf.com/?page=api_isni&id={identifiant}&isni={isni}&gabarit=auteur_json

L’API renvoi 3 types d’info dans un fichier json :
 ISNIinvalid si l’ISNI ne fait pas 16 chiffres
 ISNInotfound si l’ISNI n’a pas été trouvé dans la base
 L’url de la page de données si l’ISNIa été trouvé dans la base.


Algorithme de recommandation

Bibliosurf partage son algorithme de recommandation.
L’API propose en retour d’un EAN, une liste d’EAN .

Pour une recherche sur un livre en format papier

https://www.bibliosurf.com/?page=api_ean&id={identifiant}&ean={ean13}&gabarit=api_recommandation

Pour une recherche sur un livre numérique PNB

https://www.bibliosurf.com/?page=api_pnb&id={identifiant}&ean={ean13}&gabarit=api_recommandation_pnb


Animation de catalogue

Bibliosurf est en mesure d’animer des catalogues en ligne de bibliothèques, PNB ou de petites librairies grâce à de nombreux critères.

Bibliosurf propose de récupérer des flux d’EAN pour des pages d’accueil ou par un code CLIL pour les genres littéraires ou code ISO pour les pays.
Chaque flux d’EAN contient 3 tableaux :
 coups de cœur du web
 en vue dans les médias
 best sellers

Les codes CLIL utilisés sur Bibliosurf :
roman : 3442
récit : 3641
roman policier et roman noir : 3448
science-fiction : 3466
roman historique : 3489
recueil de nouvelles : 3621
roman de fantasy : 3478
roman d’espionnage : 3447
roman fantastique : 3474
essai : 3643

Codes ISO : fr, us, it... Seulement quelques pays n’ont pas de référence sur Bibliosurf.

Exemple recherche accueil tous les critères
https://www.bibliosurf.com/?page=api_animation&id={identifiant}&accueil=1

Exemple recherche CLIL
https://www.bibliosurf.com/?page=api_animation&id={identifiant}&clil=3442

Exemple recherche ISO
https://www.bibliosurf.com/?page=api_animation&id={identifiant}&iso=fr

Pour une recherche PNB, remplacer api_animation par api_animation_pnb.

La base est fortement structurée et connectée à ce que dit le web. D’après les recherches effectuées sur le site, Bibliosurf est en mesure d’envoyer des listes de thématiques en vue ou des données liées à une activité littéraire du moment : rentrée littéraire, grand festival.

L’url pour accéder à ces thématiques en vue est

https://www.bibliosurf.com/?page=api_themes&id={identifiant}

Le fichier json contient un jeux de données construit sur ce type :

"nom de la thématique" :"#ID"

Il suffit ensuite pour récupérer les EAN liés à cet ID d’interroger l’API animation.

Pour les EAN format papier

https://www.bibliosurf.com/?page=api_animation&id={identifiant}&tag={id}

Pour une recherche PNB, remplacer api_animation par api_animation_pnb.

Bibliosurf est aussi en mesure d’adresser des flux de podcasts liés à des EAN pour un lecteur à la une ou des flux de vidéos pour un mur de vidéos.