-
Notifications
You must be signed in to change notification settings - Fork 0
API COUVERTURE SERVICE
L'API couverture service permet d'afficher la première et la quatrième page de couverture des documents édités ou diffusés en France, et reçus par la BnF au titre du Dépôt Légal.
L'API couverture service est une API "URL" en mode GET qui donne l'image (de la première ou de la quatrième de couverture) du document au format jpeg ou png.
URL : http://catalogue.bnf.fr/couverture
Paramètres de l'URL :
| Paramètre | Obligatoire | Format | Valeur | Libellé |
|---|---|---|---|---|
| appName | Oui | String | NE | L'application appelante. La valeur à utiliser est "NE" |
| idArk | Oui | String | - | L' identifiant ARK du document (requis si idImage non utilisé) |
| couverture | Oui | Numérique | 1 ou 4 | 1 pour la première de couverture , 4 pour la quatrième de couverture |
| largeur | Non | Numérique | - | La largeur de l'image |
| hauteur | Non | Numérique | - | La hauteur de l'image |
| idImage | Oui | Numérique | - | L'identifiant de l'image du document (requis si idArk non utilisé) |
Exemples :
Récupération de la première page de couverture avec idArk:
http://catalogue.bnf.fr/couverture?&appName=NE&idArk=ark:/12148/cb450989938&couverture=1
Récupération de la quatrième page de couverture avec idArk:
http://catalogue.bnf.fr/couverture?&appName=NE&idArk=ark:/12148/cb450989938&couverture=4
Récupération de la première page de couverture en mode vignette avec idArk:
http://catalogue.bnf.fr/couverture?&appName=NE&idArk=ark:/12148/cb450989938&couverture=1&largeur=100&hauteur=250
Récupération de la première page de couverture avec idImage:
http://catalogue.bnf.fr/couverture?&appName=NE&idImage=210832&couverture=1
Récupération de la quatrième page de couverture avec idImage:
http://catalogue.bnf.fr/couverture?&appName=NE&idImage=210833&couverture=4
Récupération de la première page de couverture en mode vignette avec idImage:
http://catalogue.bnf.fr/couverture?&appName=NE&idImage=210832&couverture=1&largeur=100&hauteur=250
L' API est une API "URL" en mode GET. Cette API est très simple à utiliser.
Les documents qui possèdent des pages de couverture sont visibles dans http://nouveautes-editeurs.bnf.fr/. http://nouveautes-editeurs.bnf.fr/ offre l'accès aux documents qui sont parus il y a moins de 6 mois ou qui vont paraître dans les 6 prochains mois.
http://bibliographienationale.bnf.fr/ (utilisation avec idArk).
http://catalogue.bnf.fr/ (utilisation avec idImage).
-
Utilisation par la Bibliographie nationale (http://bibliographienationale.bnf.fr/).
Par exemple en feuilletant le numéro 20/2016 (24 oct 2016) sur le cadre de classement 004 informatique (http://bibliographienationale.bnf.fr/Livres/M20_16.h/cadre004-1.html), une liste de titres s'affiche avec des vignettes de première page de couverture. Un livre blanc représente une absence de page de couverture.
Cliquer sur FRBNF45098993 du titre "Joomla! 3 le livre pour tous V.6". Ce lien pointe sur http://catalogue.bnf.fr/ark:/12148/cb450989938. Ici ark:/12148/cb450989938 représente l'idArk.
La Bibliographie nationale a appelé l'API couverture service avec l'URL suivante :
http://catalogue.bnf.fr/couverture?&appName=NE&idArk=ark:/12148/cb450989938&couverture=1 👍 -
Utilisation par le catalogue (http://catalogue.bnf.fr/). L'affichage de page de couverture d'un document est réalisé à partir de la présence de la zone 950 de la notice au format Intermarc.
Par exemple, depuis le catalogue (http://catalogue.bnf.fr/), faire une recherche : "joomla".
Une liste de notices s'affiche comme résultat. Des vignettes s'affichent si la zone 950 est présente dans la notice.
Cliquer sur la vignette bleue correspondant au titre "Joomla! 3, le livre pour tous V.6".
Afficher le format Intermarc :
950 .. $a 210832 $b C1 950 .. $a 210833 $b C4
En fin de notice, 2 zones "950" sont présentes. Une pour la première page de couverture , une pour la quatrième page de couverture. Le $a représente l'idImage, le $b le numéro de la page de couverture sans le "C".
Le catalogue a appelé l'API couverture service avec les 2 URL suivantes:<BR>
http://catalogue.bnf.fr/couverture?&appName=NE&idImage=210832&couverture=1 :+1:<BR>
http://catalogue.bnf.fr/couverture?&appName=NE&idImage=210833&couverture=4 :+1:<BR>