Vue d'ensemble
L’interconnexion entre votre système d’information et les Web Services Neteven consistera dans la majorité des cas au développement d’un module applicatif chargé d’accéder en lecture/écriture à votre système d’information et d’effectuer des requêtes via internet à nos serveur.
Le déclenchement d’une synchronisation d’information est donc initié par le client de manière automatique (schedule via une crontab par exemple ou bien déclenché par une mise à jour des informations dans votre SI) ou manuelle (via un bouton sur le back office).
Nos Web Services utilisent le protocole SOAP.
Les Web Services de Neteven se fondent sur HTTP (ou HTTPS), SOAP et WSDL.
SOAP (Simple Object Access Protocol) est un protocole standardisé par le W3C, utilisant la notation XML permettant de définir les mécanismes d’échanges d’information entre des clients et des fournisseurs de services Web.
Le protocole SOAP permet donc de bénéficier de tous les avantages en termes de fiabilité et de robustesse que l’utilisation d’un standard peut apporter. De plus, l’utilisation des librairies SOAP disponibles allège notablement le travail des équipes de développement.

La partie communication Neteven de votre applicatif implique de manière générale l’utilisation d’une librairie SOAP spécifique à votre langage de développement, des librairies open source sont disponibles dans la quasi totalité des langages de développement (Python, PHP, JAVA, Visual Basic/.NET, Ruby, etc…).
Durant vos phases de test et d’intégration, les équipes techniques de Neteven sont à votre disposition afin de valider conjointement le bon fonctionnement de la communication Web Service mise en place.
D’un point de vue technique, les pré-requis pour une communication Web Service avec Neteven sont :
- Utilisation d’un langage de développement pouvant prendre en charge des communications SOAP
- Conformité des requêtes effectuées avec le référentiel WSDL de Neteven
Indépendamment du langage utilisé, le mode opératoire utilisé par le script de communication reste globalement le suivant :
- Inclusion/chargement de la librairie SOAP
- Initialisation éventuelle de cette librairie à partir de l’URL du WSDL Neteven
- Authentification (avec les login et mot de passe de votre compte Neteven)
- Exécution de la requête (méthode appelée + paramètres)
- Traitement de la réponse
Illustration avec un exemple (en langage Iron python) d'appel à la méthode de test "Echo" de nos Web Services :
(Cette méthode donne en résultat la valeur envoyée en paramètre).
Ces quelques lignes de code ont provoqué une requête SOAP du client (script) vers le serveur (Web Service Neteven) qui a été générée automatiquement par la librairie SOAP utilisée, le contenu des messages échangés entre les deux machines étant le suivant :
Contenu de la requête message envoyée par le client Web Service :
Contenu de la réponse envoyée par le serveur :
Vous trouverez en annexes des exemples de script dans différents langages, mais cet exemple donne une idée assez représentative de la simplicité d’utilisation des Web Services Neteven grâce à l’utilisation de SOAP/WSDL. Accéder à la page Référence du WSDL