Soap Client

admin

On the client side, we use the WSDL (Web Service Description Language) to automatically generate a JavaScript proxy class so as to allow using the Web Service return types - that is similar to what Visual Studio does when a Web Reference is added to the solution. The following diagram shows the SOAP Client workflow for asynchronous calls. The client contains one method (getCountry) that does the actual SOAP exchange. In this method, both the GetCountryRequest and the GetCountryResponse classes are derived from the WSDL and were generated in the JAXB generation process (described in Generate Domain Objects Based on a WSDL ). The message was incorrectly formed or contained incorrect information. 4: SOAP-ENV:Server. There was a problem with the server, so the message could not proceed. SOAP Fault Example. The following code is a sample Fault.

A fast and modern Python SOAP client

Highlights:
  • Compatible with Python 3.6, 3.7, 3.8 and PyPy
  • Build on top of lxml and requests
  • Support for Soap 1.1, Soap 1.2 and HTTP bindings
  • Support for WS-Addressing headers
  • Support for WSSE (UserNameToken / x.509 signing)
  • Support for asyncio via httpx
  • Experimental support for XOP messages
Soap Client

A simple example:

Quick Introduction¶

Zeep inspects the WSDL document and generates the corresponding code to use theservices and types in the document. This provides an easy to use programmaticinterface to a SOAP server.

The emphasis is on SOAP 1.1 and SOAP 1.2, however Zeep also offers support forHTTP Get and Post bindings.

Parsing the XML documents is done by using the lxml library. This is the mostperformant and compliant Python XML library currently available. This resultsin major speed benefits when processing large SOAP responses.

The SOAP specifications are unfortunately really vague and leave a lot ofthings open for interpretation. Due to this there are a lot of WSDL documentsavailable which are invalid or SOAP servers which contain bugs. Zeep tries tobe as compatible as possible but there might be cases where you run intoproblems. Don’t hesitate to submit an issue in this case (but please firstread Reporting bugs).

Installation¶

Soap Client Windows

Zeep is a pure-python module. This means that there is no C code which needsto be compiled. However the lxml dependency does contain C code since it useslibxml2 and libxslt. For linux/bsd this means you need to install libxml2-devand libxslt-dev packages. For Windows this is unfortunately a bit morecomplicated. The easiest way is to install lxml via wheel files since thatcontains already compiled code for your platform.

Client

To install wheel files you need a recent pip client. Seehttps://pip.pypa.io/en/stable/installing/ how to install pip on your platform.

If you have installed pip then run:

Soap Client

Note that the latest version to support Python 2.7, 3.3, 3.4 and 3.5 is Zeep 3.4,install via pip install zeep3.4.0

This assumes that there are wheel files available for the latest lxml release.If that is not the case (https://pypi.python.org/pypi/lxml/) then firstinstall lxml 4.2.5 since that release should have the wheel files for allplatforms:

When you want to use wsse.Signature() you will need to install the pythonxmlsec module. This can be done by installing the xmlsec extras:

For the asyncio support in Python 3.6+ the httpx module is required, thiscan be installed with the async extras:

Getting started¶

The first thing you generally want to do is inspect the wsdl file you need toimplement. This can be done with:

See python-mzeep--help for more information about this command.

Note

Zeep follows semver for versioning, however bugs can always occur.So as always pin the version of zeep you tested with(e.g. zeep4.0.0’).

A simple use-case¶

C# Soap Client

To give you an idea how zeep works a basic example.

The WSDL used above only defines one simple function (Method1) which ismade available by zeep via client.service.Method1. It takes two argumentsand returns a string. To get an overview of the services available on theendpoint you can run the following command in your terminal.

Client

Note

Note that unlike suds, zeep doesn’t enable caching of the wsdl documentsby default. This means that everytime you initialize the client requestsare done to retrieve the wsdl contents.

User guide¶

  • The Client object
  • Settings
  • Transports
  • Datastructures
  • WS-Security (WSSE)
  • Plugins
  • Reporting bugs

API Documentation¶

Changelog¶

Soap Client C#

  • Changelog