Référence du WSDL
WSDL (Web Service Description Language) est une spécification XML permettant de décrire les opérations (méthodes, paramètres et valeurs de retour) que le service propose.
Le fichier WSDL permet de fournir aux développeurs toutes les informations nécessaires à la préparation des messages (requêtes possibles, informations attendues, format des données) et aux traitements des réponses.
L’URL du WSDL de Neteven est la suivante https://ws1-1.neteven.com/NWS
Dans l’exemple précédent nous appelons une méthode nommée "Echo" vers les Web Services Neteven avec un seul paramètre de type chaîne de caractères, la réponse reçue (chaîne de caractères) est affichée directement mais pourrait aussi bien être traitée par le script.
Le nom de la méthode, ses paramètres associés ainsi que le format du résultat sont tous décrits explicitement par le fichier WSDL.
Un document WSDL est un fichier au format XML utilisant les éléments suivants :
- portType, définissant le service web, en particulier les opérations qu’il réalise et le type de messages échangés
- message, comprenant une ou plusieurs parties représentant les paramètres d’entrée
- types, définissant les types des données utilisées par le service web
- binding, précisant le protocole utilisé et le format de message
Voici un extrait du WSDL correspondant à la description de la requête "Echo" :
Bien que les différentes méthodes utilisables par nos Web Services soient décrites dans les chapitres suivant, le fichier WSDL reste une source d’information complémentaire indispensable aux développeurs chargés de s’interfacer avec nos services.
De plus, de par sa précision et son exhaustivité, le WSDL formalise de fait la structure des messages, apportant ainsi une garantie forte en terme de fiabilité et de stabilité du flux de communication qui sera mis en place entre nos systèmes d’information.