Webservice multiwhere

Objet

Ce webservice permet de localiser (RCR de localisation) plusieurs documents à partir de leur identifiant (PPN)

Un service where a été précédemment développé pour permettre la localisation d'un seul document à partir de son identifiant (PPN).

Il est dorénavant conseillé d'utiliser le multiwhere qui offre un service plus complet et plus riche, du fait de l'enrichissement des notices RCR avec des 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 http://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

http://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

http://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