Webservice multiwhere

Objet

Ce webservice renvoie, pour un PPN bibliographique--envoyé en paramètre de la requête--, les bibliothèques(RCR) qui sont localisées sur la notice.

Pour chaque bibliothèque disposant d'un exemplaire, le webservice fournit les informations de géolocalisation (latitude et longitude)

Remarque

RCR[1] = chaque bibliothèque du réseau Sudoc possède un identifiant dans le Répertoire des Centres de Ressources. Précisons que le RCR est un identifiant national de bibliothèque, qui devient un identifiant international (ISIL) si vous le préfixez de “FR-”.

par exemple 341725201 est le n° RCR du Centre de documentation de l'ABES

PPN[2] = chaque notice RCR décrivant les informations (adresse, coordonnées, services) d'une bibliothèque est identifiée par un n° PPN dans le catalogue Sudoc.

par exemple 050947664 est le n°PPN de la notice RCR du centre de documentation de l'Abes dans le Sudoc

Nom du service

<sudoc service="multiwhere">

ExempleStructure de l'information dans la notice en xml

Notice RCR du centre de documentation de l'ABES dont le PPN est 050947664 dans le Sudoc https://www.idref.fr/050947664.xml

Les informations de géolocalisation sont renseignées en zone : 202 $aLatitude $bLongitude

</datafield>

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

<subfield code="a">43.6363048</subfield>

<subfield code="b">3.8284966</subfield>

</datafield>

Réponse en format XML

Par défaut, le format de sortie est en xml

Exemple

Exemple

https://www.sudoc.fr/services/multiwhere/144089661

1
<sudoc service="multiwhere">
2
3
<query>
4
5
<ppn>144089661</ppn>
6
7
<result>
8
9
<library>
10
11
<rcr>130012101</rcr>
12
13
<shortname>AIX-MARSEILLE1-BU Lettres</shortname>
14
15
<latitude>43.516025</latitude>
16
17
<longitude>5.448238</longitude>
18
19
</library>
20
21
<library>
22
23
<rcr>130012102</rcr>
24
25
<shortname>AIX-MARSEILLE3-BU Droit Sci.Eco.</shortname>
26
27
<latitude>43.519271</latitude>
28
29
<longitude>5.4467564</longitude>
30
31
</library>
32
33
<library>
34
35
<rcr>173002101</rcr>
36
37
<shortname>LA ROCHELLE-BU</shortname>
38
39
<latitude>46.1523269</latitude>
40
41
<longitude>-1.1531369</longitude>
42
43
</library>
44
45
<library>
46
47
<rcr>290192103</rcr>
48
49
<shortname>BREST-BU Droit-Sciences-Sports</shortname>
50
51
<latitude>48.40063989999999</latitude>
52
53
<longitude>-4.4999641</longitude>
54
55
</library>
56
57
<library>
58
59
[...]
60
61
</result>
62
63
</query>
64
65
</sudoc>
66
67

Réponse en format 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

https://www.sudoc.fr/services/multiwhere/144089661&format=text/json

1
{
2
  "sudoc": {
3
    "query": {
4
      "result": {
5
        "library": [
6
7
          {
8
9
            "longitude": "5.448238",
10
11
12
            "shortname": "AIX-MARSEILLE1-BU Lettres",
13
14
            "latitude": "43.516025",
15
16
            "rcr": "130012101"
17
18
          },
19
20
          {
21
22
            "longitude": "5.4467564",
23
24
            "shortname": "AIX-MARSEILLE3-BU Droit Sci.Eco.",
25
26
            "latitude": "43.519271",
27
28
            "rcr": "130012102"
29
30
          },
31
32
          {
33
34
            "longitude": "-1.1531369",
35
36
            "shortname": "LA ROCHELLE-BU",
37
38
            "latitude": "46.1523269",
39
40
            "rcr": "173002101"
41
42
          },
43
44