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)

Team Leader de l’équipe BU sur le produit ServiceNav, ma priorité est la satisfaction de nos clients. Passionné depuis de longues années par les objets connectés et les nouvelles technologies, je mets en œuvre leur supervision au quotidien.