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

Publicités

2 réflexions sur “Micro Web Service Biblio : quels sont les documents rattachés à cette personne ?

  1. Pingback: Les Micro Web Services ABES « Punktokomo ;
  2. Pingback: IdRef dans votre application « Punktokomo ;

Les personnes disposent d’un droit d’accès aux informations contenues dans cette zone de texte. Les informations que vous y inscrivez doivent être pertinentes au regard du contexte. Elles ne doivent pas comporter d’appréciation subjective, ni faire apparaître, directement ou indirectement les origines raciales, les opinions politiques, philosophiques ou religieuses, les appartenances syndicales ou les mœurs de la personne concernée.

Entrez vos coordonnées ci-dessous ou cliquez sur une icône pour vous connecter:

Logo WordPress.com

Vous commentez à l'aide de votre compte WordPress.com. Déconnexion / Changer )

Image Twitter

Vous commentez à l'aide de votre compte Twitter. Déconnexion / Changer )

Photo Facebook

Vous commentez à l'aide de votre compte Facebook. Déconnexion / Changer )

Photo Google+

Vous commentez à l'aide de votre compte Google+. Déconnexion / Changer )

Connexion à %s