Utiliser les WebServices ServiceNav

ServiceNav publie de nombreux WebServices permettant d’accèder depuis un système distant à un grand nombre d’informations et d’éxécuter une partie des opérations d’ajout/modification/suppression des éléments d’exploitation

Documentation complète des WebServices : La documentation complète des WebServices est disponible ici : SN API Webservice_Signatures_V1.29

L’accès au WebServices se fait sur l’adresse suivante : https://<url_plateforme>/api/mobility .

Pour nos clients bénéficiant de notre plateforme SaaS, l’accès se fait directement sur l’adresse : https://servicenav.io/api/mobility/

Exemple de code php, permettant de retourner la liste des Services Utilisateurs d’une société.

Dans cet exemple, l’identification est réalisée à chaque appel. Comme indiqué dans la documentation, il est possible d’utiliser une session si plusieurs appels doivent être réalisés à la suite. La fonction getSession.php et l’utilisation du param « session » dans l’ensemble des appels sera à utiliser.

La visibilité et les actions possibles via les WebServices sont les mêmes que celles possible dans l’interface avec le même compte utilisateur.

<?php
//Plateform credentials
$plateformURL='https://servicenav.io/api/mobility';
$plateformUser='user@mail.fr';
$plateformPassword='password';

//Filters parameters
$companytoken = '721f92cbba5deef08a29adea5545cc0b';
$filter = '{"entity":"10","attribut":"6","values":["' . $companytoken . '"]}';
//entity : 10 ==> Company / attribut : 6 ==> Token / values : 721f92cbba5deef08a29adea5545cc0b ==> Token value of company

//Call to getListServiceUserShortDescription function.
$requestURL = $plateformURL . '/getListServiceUserShortDescription.php?param={"filter":[' . $filter.']}';
$ch = curl_init();
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_URL,$requestURL);
curl_setopt($ch, CURLOPT_USERPWD, $plateformUser.':'.$plateformPassword);
$result=curl_exec($ch);

if ($result === false) 
{ 
      echo "request = $requestURL<br />";  
      echo "status code = " . curl_getinfo($ch, CURLINFO_HTTP_CODE);
      curl_close($curl); 
      die('Une erreur est survenue lors de la récupération des informations.');
} 
curl_close($ch);

//Json output

$response = json_decode($result, true);
print_r ($response);

?>

Note : Dans le cas d’appels de contacts et/ou de société, la documentation peut indiquer l’information suivante : Liste : ID des contacts (Couples d’ID pour les contacts <idMonitoring>,<idTicketing> ). L’idTicketing n’est pas une donnée utile dans le cadre des WebServices ServiceNav, il convient donc de présenter la valeur sous la forme suivante : [« 3, »]  (où 3 est l’idMonitoring)