IdRef pour les développeurs

3.9. Micro Web Service “iln2rcr”

Objet

A partir d’un numéro ILN : obtenir la liste de ses RCR

NB : un RCR est un numéro identifiant d’un établissement dans le Répertoire des Centres de Ressources

Exemple : Numéro identifiant une bibliothèque dans les réseaux SUDOC

ABES Centre de documentation : 341725201

ILN : Numéro identifiant un groupe de RCR partageant le même SIGB (Système Intégré de Gestion des Bibliothèques) : catalogue Local.

Exemple : l’ILN 006 regroupe 7 RCR

Nom du service : <sudoc service="iln2rcr">

Requête

http://www.idref.fr/services/iln2rcr/4

Requête multiple possible

http://www.idref.fr/services/iln2rcr/4,8

Réponse en XML

<sudoc service="iln2rcr">

<query>

<iln>4</iln>

<result>

<library><rcr>040702201</rcr>

<name>Institut universitaire de technologie</name>

<address>Rue Pasteur 04000 Digne-les-bains FR</address>

<latitude>44.091451</latitude>

<longitude>6.227104</longitude>

</library>

<library><rcr>040702202</rcr>

<name>Université de Provence</name>

<address>15 Avenue Reinach 04002 Digne-les-Bains FR</address>

<latitude>44.0953376</latitude>

<longitude>6.232774999999999</longitude>

</library>

<library><rcr>041922301</rcr>

<name>Observatoire astronomique de Marseille-Provence</name>

<address>Saint-Michel 04870 Saint-Michel-l'Observatoire FR</address>

<latitude>43.902183</latitude>

<longitude>5.716404</longitude>

</library>

</result>

</query>

</sudoc

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 : en complétant l’URL de base de l’information suivante &format=text/json

Exemple :

http://www.idref.fr/services/iln2rcr/4&format=text/json

Exemple de réponse en JSON

{

"sudoc": [

{

"query": {

"iln": 4,

"result": [

{

"library": {

"rcr": "040702201",

"name": "Institut universitaire de technologie",

"address": "Rue Pasteur 04000 Digne-les-bains FR",

"latitude": 44.091451,

"longitude": 6.227104

}

},

{

"library": {

"rcr": "040702202",

"name": "Université de Provence",

"address": "15 Avenue Reinach 04002 Digne-les-Bains FR",

"latitude": 44.0953376,

"longitude": 6.232774999999999

}

},

Affichage de la géolocalisation

En ajoutant &format=text/html à la requête, Iln2rcr affiche les RCR demandés sur une carte.

Exemple

http://www.idref.fr/services/iln2rcr/4,5,6&format=text/html