Logo BnF

API et jeux de données

fr
  • Accueil
    • Gallica
    • data.bnf.fr
    • Dépôt légal du Web
    • Catalogue collectif de France (CCFr)
    • Catalogue général de la BnF
    • Mandragore
    • BnF Archives et Manuscrits
    • Bibliographique des éditions parisiennes du XVIe siècle
    • Reliures
    • Données statistiques
    • Voir toutes les sources
    • Expérimentations
    • Projets de recherche
    • Tutoriels & outils
  • Services
  1. Vous êtes ici : Accueil
  2. API OPDS Du Catalogue De Livres Numériques De Gallica
EPUB OPDS Textes

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
    Accès

    https://gallica.bnf.fr/opds

    https://gallica.bnf.fr/services/engine/search/opds?operation=searchRetri...

    Fiche Technique
    Version

    1

    Format

    EPUB

    Licence

    Conditions d'utilisation des contenus de Gallica

    Technologies

    OPDS

    Sujets

    Textes

    Contact
    gallica@bnf.fr
    Partage
    Twitter Facebook Linkedin
    • © 2020 BnF
    • A propos
    • Conditions d'utilisation
    • Mentions légales
    • Politique de confidentialité
    • RSS
    • Écrire à la BnF
    • Accessibilité (non conforme)
    • DCAT
    twitter facebook instagram youtube