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> |
Structure d'une requête⚓
ISBN-10
https://www.sudoc.fr/services/isbn2ppn/0195141156 (ISBN-10 sans tiret)
https://www.sudoc.fr/services/isbn2ppn/2-07-037026-7 (ISBN-10 avec tirets)
ISBN-13
https://www.sudoc.fr/services/isbn2ppn/978-1-11-113772-4 (ISBN-13 avec tirets)
https://www.sudoc.fr/services/isbn2ppn/9781111137724 (ISBN-13 sans tiret)
Structure d'une requête multiple⚓
ISBN-10
https://www.sudoc.fr/services/isbn2ppn/2-07-037026-7,2-05-100362-9,201000535X (ISBN-10 multiple)
ISBN-13
https://www.sudoc.fr/services/isbn2ppn/978-2-7073-1326-3,978-1-11-113772-4 (ISBN-13 multiple)
Attention : Remarques 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⚓
<sudoc>
<query>
<isbn>0-19-514114-8</isbn>
<result>
<ppn>06735209X</ppn>
</result>
</query>
</sudoc>
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 :
https://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.
{"sudoc": [
{"query": {
"isbn": "2-07-037026-7",
"result": [
{"ppn": "00021650X"
},
{"ppn": "007148747"
},
{"ppn": "008518912"
},
],
"resultNoHolding":[
{"ppn":"003640507"
},
{"ppn":"060933356"
},
{"ppn":"075250543"
}
]
}
}
}