Webservice isbn2ppn

Objet

Ce webservice renvoie le PPN à partir de la zone 010 $a ISBN valide

Nom du service

<sudoc service="isbn2ppn">

Structure de l'information dans la notice

010 <subfield code="a">

La 010 est répétable.

<datafield tag="010" ind1=" " ind2=" ">

<subfield code="a">2-07-037026-7</subfield>

</datafield>

AttentionRemarques sur la recherche par ISBN

Normalement l'ISBN a des tirets, mais, dans certains contextes, ils disparaissent. Pour éviter cette incertitude sur la présence ou non de tirets, isbn2ppn doit normaliser l'ISBN et être capable de trouver les mêmes PPN, que la notice MARC contienne ou non les tirets.

Pour mémoire, une fois normalisés, les ISBN corrects font soit 10 soit 13 caractères. Dans le cas d'un ISBN fautif de 11 caractères, le webservice renverra la réponse correspondant à une interrogation sur les 10 premiers chiffres de cet ISBN de 11 caractères : il ne tiendra pas compte du dernier caractère, sur-numéraire. En d'autres termes, pour éviter d'avoir des réponses inconsistantes, le plus sûr est de valider ses ISBN préalablement à l'interrogation du webservice .

On trouve des ISBN dans des notices de périodiques renseignés en 010 $9 mais cette information n'est pas exploitée pour l'instant.

  • $9 ISBN d'une livraison de publication en série

La sous-zone $9 ne s'emploie que dans les notices de « périodique». Elle contient l'ISBN valide d'une livraison.

La mention d'un ISBN dans une notice de publication en série se fait exclusivement en 010 $9, dans une zone 010 unique.

La sous-zone $9 est répétable.

Exemple :

Agrégation. Anglais, ISSN 0984-6417 010 ##$92-240-70686-4$92-240-70665-1$92-240-70879-4$92-240-70897-2$92-240-71151-5$92-240-71171-X$92-240-71408-5$92-240-71432-8$92-240-71748-3$92-240-71777-7$92-240-71748-3$92-240-72016-6$92-240-72042-5$92-240-72335-1$92-240-72330-0$92-240-72575-3$92-240-72690-3$92-240-72910-4$92-240-72804-3$92-240-00935-7$92-240-73046-3$92-240-01475-X$92-240-01215-3$92-240-01737-6

Réponse XML

1
<sudoc>
2
3
<query>
4
5
<isbn>0-19-514114-8</isbn>
6
7
<result>
8
9
	<ppn>06735209X</ppn>
10
11
</result>
12
13
</query>
14
15
</sudoc>
16
17

NB : <result> peut contenir 0, 1 ou n <ppn>

Réponse en JSON

Il est possible de demander une réponse dans le format JSON

En appelant l'URL de base en précisant dans le Header de 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.

En complétant l'URL de base de l'information suivante &format=text/json

Exemple

Exemple

http://www.sudoc.fr/services/isbn2ppn/2-07-037026-7&format=text/json

Les notices bibliographiques dont les PPN sont regroupés sous la clé "result" possèdent un exemplaire, celles dont les PPN sont regroupés sous la clé "resultNoHolding" ne possèdent pas d'exemplaire.

1
2
{
3
4
  "sudoc": [
5
6
    {
7
8
      "query": {
9
10
        "isbn": "2-07-037026-7",
11
12
        "result": [
13
14
          {
15
16
            "ppn": "00021650X"
17
18
          },
19
20
          {
21
22
            "ppn": "007148747"
23
24
          },
25
26
          {
27
28
            "ppn": "008518912"
29
30
          },
31
32
	],
33
34
	"resultNoHolding":[
35
36
	{
37
38
	 "ppn":"003640507"
39
40
	},
41
42
	{
43
44
	 "ppn":"060933356"
45
46
	},
47
48
	{
49
50
	 "ppn":"075250543"
51
52
	}
53
54
	]
55
56
	}
57
58
  }
59
60
}