Formateur WSDL

Formatez et analysez vos définitions de services WSDL.

WSDL Source

Formatage

Options

WSDL Formaté

Guide complet : WSDL pour la description de services web

WSDL : le contrat des services web SOAP

WSDL (Web Services Description Language) est un format XML standardisé par le W3C pour décrire les services web SOAP. Il définit un contrat formel : quelles opérations sont disponibles, quels paramètres elles acceptent, quels résultats elles retournent, et comment y accéder. C'est l'équivalent SOAP de ce qu'OpenAPI/Swagger est pour REST.

J'ai passé d'innombrables heures à analyser des WSDL pour intégrer des services bancaires et ERP. La beauté du WSDL est sa formalité : avec un fichier WSDL, les outils génèrent automatiquement tout le code client nécessaire. Pas de documentation ambigüe — le contrat est la documentation.

Structure détaillée d'un WSDL

📊 types

Schemas XSD définissant les structures de données : types complexes, éléments, restrictions. La base de tout échange de données.

📨 message

Définit les messages input/output de chaque opération. Chaque message a des "parts" référençant les types.

🔌 portType (interface)

Interface abstraite : liste des opérations avec leurs messages input/output/fault. Le "quoi" du service.

⛓️ binding

Lie l'interface à un protocole concret (SOAP). Définit style (document/rpc), transport (HTTP), et encoding.

Éléments supplémentaires WSDL

  • service : Point d'entrée concret avec l'URL du endpoint
  • port : Associe un binding à une adresse réseau
  • import : Référence d'autres WSDL ou schemas XSD externes
  • documentation : Métadonnées lisibles par les humains

WSDL 1.1 vs WSDL 2.0

  • WSDL 1.1 : Version dominante, supportée universellement. Terminologie : portType, binding, service.
  • WSDL 2.0 : Simplifié mais peu adopté. Renomme portType en interface, simplifie la syntaxe.
  • Recommandation : Utilisez WSDL 1.1 pour la compatibilité maximale.

Traitement local : confidentialité assurée

Ce formateur traite vos fichiers WSDL entièrement dans votre navigateur. Aucune donnée n'est envoyée à un serveur — analysez vos contrats de services propriétaires en toute confiance.

Questions fréquentes sur WSDL

Comment lire un WSDL pour comprendre un service ?

Approche "bottom-up" (recommandée) :

  • service : Trouvez l'URL du endpoint
  • binding : Identifiez le protocole (SOAP 1.1/1.2) et le style
  • portType : Listez les opérations disponibles
  • message : Examinez les paramètres input/output
  • types : Analysez les structures de données

Outils visuels : SoapUI, Oxygen XML, ou l'analyse de cet outil pour une vue synthétique.

Document vs RPC style : quelle différence ?

RPC/encoded (legacy) :

  • Paramètres wrappés dans un élément nommé selon l'opération
  • Types encodés avec attributs xsi:type
  • À éviter (non WS-I compliant)

Document/literal (standard) :

  • XML conforme exactement au schema XSD
  • Pas de wrapper additionnel
  • Préféré et WS-I compliant

Document/literal wrapped : Variante courante qui ajoute un wrapper nommé.

Comment générer du code client depuis un WSDL ?

Par langage :

  • Java : wsimport (JDK), Apache CXF wsdl2java, Axis2
  • C#/.NET : svcutil.exe, Visual Studio "Add Service Reference"
  • Python : zeep (moderne), suds-community
  • PHP : SoapClient natif avec l'URL WSDL
  • Node.js : node-soap, easy-soap-request

Ces outils créent les classes, types et méthodes pour appeler le service.

WSDL vs OpenAPI : lequel pour un nouveau projet ?

Préférez OpenAPI/REST pour les nouveaux projets :

  • Plus simple, plus léger (JSON vs XML)
  • Écosystème d'outils moderne
  • Meilleur pour web et mobile

WSDL/SOAP reste pertinent pour :

  • Intégration avec systèmes legacy
  • Exigences WS-Security (sécurité au niveau message)
  • Transactions distribuées (WS-AtomicTransaction)
  • Standard imposé par partenaire/régulateur

Comment valider un fichier WSDL ?

Validation syntaxique :

  • Vérifiez que le XML est bien formé (cet outil)
  • Validez contre le schema WSDL officiel

Validation sémantique :

  • SoapUI importe et valide automatiquement
  • xmllint avec les schemas XSD référencés
  • Oxygen XML Editor pour une validation complète

Vérification WS-I : Utilisez WS-I Testing Tools pour la conformité aux standards.

Mes fichiers WSDL sont-ils sécurisés avec cet outil ?

Oui, totalement. Le formatage et l'analyse s'exécutent entièrement dans votre navigateur :

  • Parsing XML en JavaScript local (DOMParser)
  • Aucune requête réseau n'envoie vos données
  • Vos contrats de service ne quittent jamais votre machine
  • L'outil fonctionne même hors ligne après chargement

Idéal pour analyser des WSDL internes ou sensibles.