API OPDS du catalogue de livres numériques de Gallica

Présentation

Cette API expose la bibliothèque de livres numériques au format EPUB de Gallica.

Le catalogue OPDS Gallica permet d'agréger et de distribuer les livres numériques au format EPUB présents dans Gallica. Ces EPUB ont été produits par la BnF à partir d'ouvrages du domaine public.  La spécification OPDS se base sur le format de syndication de flux Atom.

Console

Utilisation

Le service OPDS de Gallica se déploie sous deux formes :

• un catalogue, principalement organisé autour de flux thématiques (littérature, histoire, sciences...). L'URL de ce catalogue OPDS est https://gallica.bnf.fr/opds
• un service de recherche, basé sur le protocole SRU. L'URL de ce service est  https://gallica.bnf.fr/services/engine/search/opds?operation=searchRetri...

Des exemples de recherches sont inclus dans le catalogue OPDS, lequel utilise le protocole SRU pour interroger Gallica. Ainsi, le flux "Sciences" est formé à l'aide de l'indexation Dewey (5) et du critère format=EPUB :

https://gallica.bnf.fr/services/engine/search/opds?operation=searchRetrieve&version=1.2&exactSearch=false&query=dewey all "5" and dc.formatspecific all "epub"&filter=provenance all "bnf.fr"

L'API retourne un flux XML :

<?xml version="1.0" encoding="UTF-8" ?>
<feed xmlns:app="http://www.w3.org/2007/app" 
xmlns:opds="http://opds-spec.org/2010/catalog" 
xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" 
xmlns:odl="http://opds-spec.org/odl" 
xmlns:dcterms="http://purl.org/dc/terms/" 
xmlns="http://www.w3.org/2005/Atom" 
xmlns:thr="http://purl.org/syndication/thread/1.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <id>gallica.bnf.fr</id>
    <title>Recherche : (dewey all "5</title>
    <updated>2018-11-22T15:33:44</updated>
    <icon>https://gallica.bnf.fr/mbImage/perso/favicon.ico</icon>
    <author>
        <name>Gallica</name>
        <uri>gallica.bnf.fr</uri>
    </author>
    <link type="application/atom+xml;profile=opds-catalog;kind=navigation" 
href="https://gallica.bnf.fr/opds?query=%28dewey+all+%225%22%29" rel="self"/>
   ...
    <link type="application/atom+xml;profile=opds-catalog;kind=navigation" 
href="https://gallica.bnf.fr/opds?query=%28dewey+all+%225%22%29&amp;startRecord=15&amp;maximumRecords=15" rel="next" title="Page suivante"/>
    <opensearch:totalResults>118</opensearch:totalResults>
    <opensearch:itemsPerPage>15</opensearch:itemsPerPage>
    <opensearch:startIndex>1</opensearch:startIndex>
    <entry>
        <title>Zoologie (6e édition) / par J.-H. Fabre,...</title>
        <id>http://gallica.bnf.fr/ark:/12148/bpt6k144253q </id>
        <updated>2011-01-24T00:00:00</updated>
        <author>
            <name>Fabre, Jean-Henri (1823-1915) </name>
            <uri>https://gallica.bnf.fr/opds?query=dc.creator all "Fabre, Jean-Henri (1823-1915) "</uri>
        </author>
        <dcterms:publisher></dcterms:publisher>
        <summary type="text">Avec mode texte</summary>
        <link type="text/html" href="http://gallica.bnf.fr/ark:/12148/bpt6k144253q " rel="alternate" title="Voir sur Gallica"/>
        <link type="image/jpeg" href="http://gallica.bnf.fr/ark:/12148/bpt6k144253q.thumbnail" rel="http://opds-spec.org/image/thumbnail"/>
        <link type="image/jpeg" href="http://gallica.bnf.fr/ark:/12148/bpt6k144253q.highres" rel="http://opds-spec.org/image"/>
        <link type="application/epub+zip" href="http://gallica.bnf.fr/ark:/12148/bpt6k144253q.epub" rel="http://opds-spec.org/acquisition" title="Ouvrir le livre"/>
    </entry>
    <entry>
        <title>La protection des oiseaux / par Émile Oustalet,...</title>
        <id>http://gallica.bnf.fr/ark:/12148/bpt6k146455n </id>
        <updated>2011-01-24T00:00:00</updated>
        <author>
            <name>Oustalet, Émile (1844-1905) </name>
            <uri>https://gallica.bnf.fr/opds?query=dc.creator all "Oustalet, Émile (1844-1905) "</uri>
        </author>
        <dcterms:publisher></dcterms:publisher>
        <summary type="text">La protection des oiseaux / par Émile Oustalet,...</summary>
        <link type="text/html" href="http://gallica.bnf.fr/ark:/12148/bpt6k146455n " rel="alternate" title="Voir sur Gallica"/>
        <link type="image/jpeg" href="http://gallica.bnf.fr/ark:/12148/bpt6k146455n.thumbnail" rel="http://opds-spec.org/image/thumbnail"/>
        <link type="image/jpeg" href="http://gallica.bnf.fr/ark:/12148/bpt6k146455n.highres" rel="http://opds-spec.org/image"/>
        <link type="application/epub+zip" href="http://gallica.bnf.fr/ark:/12148/bpt6k146455n.epub" rel="http://opds-spec.org/acquisition" title="Ouvrir le livre"/>
    </entry>
    <entry>
...

Dans ce flux, les liens vers les fichiers EPUB sont référencés par une relation d'acquisition :

rel="http://opds-spec.org/acquisition"

Documentation

Spécifications :

• http://opds-spec.org/
• http://fr.feedbooks.com/api/primer