下面是根据 WSDL 格式化 SOAP Web 服务 XML 消息的示例:
在这个例子中,我在 ; 中找到了 Zeep 分配的命名空间前缀client.wsdl.dump()
;请参阅答案底部附近的示例。
>>> import zeep
>>> client = zeep.Client('https://emaapitest.eset.com/Services/v2015_1/MSPService.svc?singleWsdl')
>>> # note - the namespace ns2 was assigned by zeep - see client.wsdl.dump() tip later in this answer
>>> license_create_type = client.get_type('ns2:LicenseCreateRequest')
>>> # Creating an empty object reminds me of the property names, so I don't have to guess
>>> license_create_type()
{
'Note': None,
'ProductCode': None,
'Quantity': None,
'ServerName': None,
'Trial': None
}
>>> my_create = license_create_type(ProductCode=112,Quantity=3,Trial=False)
>>> my_create
{
'Note': None,
'ProductCode': 112,
'Quantity': 3,
'ServerName': None,
'Trial': False
}
>>> my_type = client.get_type('ns2:SiteUpdateRequest')
>>> # Reference for specifying arrays in Zeep: https://github.com/mvantellingen/python-zeep/issues/145#issuecomment-321614947
>>> req = my_type(LoginID="123",Token="mytoken",LicenseRequests={'LicenseRequest':[my_create]})
>>> # To call the service: (assuming valid credentials?)
>>> # client.service.UpdateSite(req)
这是 Web 服务请求的 Python 视图:
>>> req
{
'LoginID': '123',
'Token': 'mytoken',
'Active': None,
'LicenseRequests': {
'LicenseRequest': [
{
'Note': None,
'ProductCode': 112,
'Quantity': 3,
'ServerName': None,
'Trial': False
}
]
},
'Name': None,
'SecurityAdminRequests': None,
'SiteID': None,
'SupportLegacyKey': None
}
这是 Web 服务请求的 XML 视图:
>>> # Debugging output to see raw XML...
>>> node = client.create_message(client.service, 'UpdateSite', req)
>>> from lxml import etree
>>> xml_str = etree.tostring(node, pretty_print=True).decode()
>>> print(xml_str)
<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">
<soap-env:Header xmlns:wsa="http://www.w3.org/2005/08/addressing">
<wsa:Action>http://tempuri.org/IMSPService/UpdateSite</wsa:Action>
<wsa:MessageID>urn:uuid:c3d7d838-6ce8-477b-ad7d-23e99e800a80</wsa:MessageID>
<wsa:To>https://emaapitest.eset.com/Services/v2015_1/MSPService.svc</wsa:To>
</soap-env:Header>
<soap-env:Body>
<ns0:UpdateSite xmlns:ns0="http://tempuri.org/">
<ns0:request>
<ns1:LoginID xmlns:ns1="http://schemas.datacontract.org/2004/07/MSPApi.Services.v2015_1.Requests">123</ns1:LoginID>
<ns2:Token xmlns:ns2="http://schemas.datacontract.org/2004/07/MSPApi.Services.v2015_1.Requests">mytoken</ns2:Token>
<ns3:LicenseRequests xmlns:ns3="http://schemas.datacontract.org/2004/07/MSPApi.Services.v2015_1.Requests">
<ns4:LicenseRequest xmlns:ns4="http://schemas.datacontract.org/2004/07/MSPApi.Services.v2015_1.ViewModels" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns3:LicenseCreateRequest">
<ns3:ProductCode>112</ns3:ProductCode>
<ns3:Quantity>3</ns3:Quantity>
<ns3:Trial>false</ns3:Trial>
</ns4:LicenseRequest>
</ns3:LicenseRequests>
</ns0:request>
</ns0:UpdateSite>
</soap-env:Body>
</soap-env:Envelope>
提示:使用client.wsdl.dump()
我通常通过阅读client.wsdl.dump()
查看 Zeep 生成的映射来启动项目,从底部的“绑定”和“操作”开始,然后通过类型向后工作。这通常是您开始所需的全部内容。
>>> import zeep
>>> client = zeep.Client('https://emaapitest.eset.com/Services/v2015_1/MSPService.svc?singleWsdl')
>>> client.wsdl.dump()
Prefixes:
myprefix: http://schemas.datacontract.org/2004/07/MSPApi.Services.v2015_1.Requests
xsd: http://www.w3.org/2001/XMLSchema
ns0: http://tempuri.org/
ns1: http://schemas.microsoft.com/2003/10/Serialization/
ns3: http://schemas.datacontract.org/2004/07/MSPApi.Services.v2015_1.Responses
ns4: http://schemas.microsoft.com/2003/10/Serialization/Arrays
ns5: http://schemas.datacontract.org/2004/07/MSPApi.Services.v2015_1.ViewModels
Global elements:
<SNIP - VERY LONG OUTPUT>
Global types:
<SNIP - VERY LONG OUTPUT>
ns2:SiteUpdateRequest(LoginID: xsd:string, Token: xsd:string, Active: xsd:boolean, LicenseRequests: ns5:ArrayOfLicenseRequest, Name: xsd:string, SecurityAdminRequests: ns2:ArrayOfSecurityAdminRequest, SiteID: xsd:long, SupportLegacyKey: xsd:boolean)
<SNIP - VERY LONG OUTPUT>
Service: MSPService
Port: BasicHttpBinding_IMSPService (Soap11Binding: {http://tempuri.org/}BasicHttpBinding_IMSPService)
Operations:
<SNIP - VERY LONG OUTPUT>
UpdateSite(request: ns2:SiteUpdateRequest) -> UpdateSiteResult: ns3:SiteDetailsResponse
<SNIP - VERY LONG OUTPUT>
>>>