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
Vous pouvez tester l’API en utilisant l’identifiant 8.
Une fois en mode de production, Il vous est demandé de signaler l’utilisation de l’API via le formulaire de contact. En retour, il sera alors communiqué un identifiant .
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.