Spécifications du service web des référentiels alphanumériques du Sandre

Le Sandre a élaboré le scénario technique * (accessible dans chapitre ci-dessous intitulé "Documents de spécification * associés > Quelques précisons > Accès") pour l'exploitation et la diffusion des jeux de données de référence * alphanumériques par des services web * . Notons que ces données sont également accessibles soit :

en téléchargeant le fichier complet de chaque référentiel * (cf. chapitre ci-dessous Associés à ce document > Données de référence * ),
en utilisant un moteur de recherche (cf. chapitre ci-dessous intitulé Services associés > Consulter une donnée d'un jeu).

Fonctionnalités

Le service web * des référentiels * du Sandre permet :

de rechercher et récupérer les jeux de données * de référence,
d'être averti des mises à jour ou de demander si une nouvelle mise à jour est disponible,
de récupérer les mises à jour des jeux de données de référence * .

A titre d'exemple, vous pouvez utiliser cette adresse qui sollicite nos services web * en mode REST. Après quelques secondes, une fenêtre s'ouvrira vous invitant à télécharger le fichier compressé. Cette adresse vous permet de télécharger les occurrences mises à jour du référentiel * Paramètres à partir du 01/01/2010. Vous pouvez changer la valeur de la variable DerniereDateDeMAJ de cette adresse pour remplacer la date de mise à jour par une autre.

Accessibilité

Le service web * des référentiels * du Sandre est accessible à l'adresse :

References.wsdl (pour l'accès en SOAP),
References.php (pour l'accès en REST).

Exemple d'implémentation pour l'utilisation du service web

En VBA pour Excel

Le Sandre a élaboré une feuille sous Excel , en langage informatique VBA, chargée de consulter ce service web * du Sandre. Attention, elle nécessite obligatoirement l'installation des bibliothèques msxml et soapsdk .

En PHP pour Apache

Le Sandre a rédigé le script ci-dessous, en langage informatique PHP, chargé de consulter ce service web * du Sandre. Il retourne la description du paramètre "1234". Attention, il nécessite obligatoirement l'installation de la bibliothèque phpsoap .

$client = new SoapClient("http://services.sandre.eaufrance.fr/References/1.1.0/References.wsdl");

$params->outputFormat = 'text/xml';

$params->outputSchema = 'http://xml.sandre.eaufrance.fr/scenario/referentiel/2/sandre_sc_referentiel.xsd';

$params->CdReferentiel = 'PAR'; $params->Filter->CdSandre = "1234";

try { $obj = $client->getReferenceElements($params); echo "&lgt;pre>";

echo $obj->Result; echo "";

}

catch (SoapFault $exception) { echo $exception; }