Micro Web Service Biblio : quels sont les documents rattachés à cette personne ?

Biblio est le premier micro Web Service IdRef proposé par l’ABES : il permet de lister les documents signalés dans le Sudoc et rattachés à la notice d’autorité d’une personne.

A partir de l’identifiant d’une notice d’autorité de personne physique du Sudoc (« PPN » pour les intimes), Biblio fournit la liste des documents liés, en précisant pour chacun d’entre eux son titre et son identifiant Sudoc (PPN).

Par exemple, l’URL suivante :

http://www.idref.fr/services/biblio/027182800

est une requête Biblio qui demande la liste des documents rattachés à Paul Veyne, identifié par 027182800.

La réponse, en XML par défaut, est la suivante :

<?xml version="1.0" encoding="UTF-8"?>
<sudoc>
  <query>
    <ppn>027182800</ppn>
  </query>
  <result>
    <name>Veyne, Paul (1930-....)</name>
    <countRoles>10</countRoles>
    <role>
      <unimarcCode>070</unimarcCode>
      <marc21Code>aut</marc21Code>
      <roleName>Auteur</roleName>
      <count>89</count>
      <doc>
        <ppn>138028052</ppn>
        <citation>[Recueil factice: Portraits antiques]  [vol.1] ,   [Texte imprimé] / [s.l.] : [s.n.] , 1904-1969</citation>
      </doc>
      <doc>
        <ppn>138507023</ppn>
        <citation>[Recueil factice : Paul Veyne : Varia]   [Texte imprimé] / [s.l.] : [s.n.] , 1957-1967</citation>
      </doc>
      (... autres docs ...)
    </role>
    <... autres rôles ...)
  </result>
</sudoc>

Cette liste de documents est une liste raisonnée, organisée par rôles. Dans l’exemple ci-dessus, on voit que Paul Veyne remplit une dizaine de fonctions : Auteur, Préfacier, Collaborateur, Éditeur scientifique, Sujet, etc. Les rôles sont mentionnés par leur libellé en français (Auteur), leur code de fonction UNIMARC (070) et leur code de fonction MARC21 (aut). Ils sont triés par code de fonction UNIMARC.

Côte technique, si vous préférez exploiter ces informations dans le contexte d’un script JavaScript, il est possible de demander une réponse dans le format JSON

• soit en ajoutant l’URL de requête le suffixe .json
• soit en appelant l’URL de base en précisant dans la requête HTTP préférer du JSON (Accept: text/json). Vous utiliserez alors le mécanisme de la négociation de contenu, que vous pouvez tester avec le plugin Firefox Modify Headers par exemple.

N’hésitez, pas en commentaires, à demander des explications complémentaires, proposer des enrichissements à ce service et nous informer de l’usage que vous envisagez d’en faire.

Documentation technique : http://documentation.abes.fr/aideidref/developpeur/ch03s03.html

Contact : passez par l’interface d’assistance > IdRef > Web Services