IdRef pour les développeurs

3.4.  Micro Web Service “biblio

En connaissant l'identifiant d'une notice d'autorité de type Personne, Famille, Titre ou Auteur/Titre, il est possible d'accéder à la liste des documents auxquels l’entité est associée dans le Sudoc.

Exemple :

Identifiant (PPN) de la notice de Paul Veyne : 027182800

URL du micro Web Service : http://www.idref.fr/services/biblio/027182800

Réponse en XML (extrait) :

<sudoc service="biblio">

<query>

<ppn>027182800</ppn>

</query>

<result>

<name>Veyne, Paul (1930-....)</name>

<countRoles>11</countRoles>

<role><unimarcCode>000</unimarcCode>

<marc21Code>x99</marc21Code>

<roleName>Code de fonction non reconnu</roleName>

<count>2</count>

<doc>

<ppn>161294731</ppn>

<citation>

Kannten die Griechen die Demokratie ? : zwei Studien / Christian Meier, Paul Veyne / Berlin : K. Wagenbach , 1988

</citation>

</doc>

Réponse en JSON :

Par défaut, l'URL http://www.idref.fr/services/biblio/027182800 renvoie de l'XML.

Grâce à la négociation de contenu, on peut demander à ce que cette URL générique renvoie spécifiquement du JSON, en précisant dans la requête http :

Accept: text/json

Enfin, il existe des URL spécifiques qui forcent le format de la réponse, comme l'indique le tableau récapitulatif suivant.

Identifiant de la notice Sudoc

027182800

URL générique

(supporte la négociation de contenu)

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

URL spécifique pour l'XML

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

URL spécifique pour le JSON

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