Documentations

Using ServiceNav WebServices

On the page

Need some help?

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 : List : 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)

This may also be of interest to you

Create companies and sites

Setting up a time slot

Optimize multi-site and multi-client configuration: inheritance and visibility rules

en_USEnglish
fr_FRFrench en_USEnglish

Welcome to ServiceNav!

Need help? More information about our products? Write to us!
You have taken note of our privacy policy.

[COVID - 19 ] - TELEWORKING, TARGET AVAILABILITY 100% !

While the epidemic lasts, ensure the availability and performance of your IT services for teleworking, with ServiceNav!

Following the government's call to mobilize to help businesses overcome the current health and economic context, we help you, free of charge, to ensure the complete monitoring of your teleworking environments: VPN, VDI, Teams, Skype Enterprise, Citrix... Objectives: collection, availability and usage indicators, dashboards to support your communication.
We use cookies to ensure that you have the best possible experience on our site, and if you continue to use this site, we will assume that you are satisfied with it.

Reserve your place

You have taken note of our privacy policy.