SOAP API提供了一种严格定义的有结构的消息系统，它通过网络交换带有信息的XML格式数据。在Python中，使用库如zeep或suds-jurko 是实现与SOAP API交互的常见方法。特别是，zeep是最受推荐的工具，不仅因为它支持Python 3.x，而且它也是目前维护最为活跃的SOAP客户端库。zeep库遵循WSDL（Web服务描述语言）来映射Python命令到SOAP请求，反之亦然。安装zeep库简单，通常只需要使用pip安装命令即可，详情可参阅zeep的官方文档。
一、安装与准备
在使用Python与SOAP API交互之前，首先需要安装必要的库。zeep库是实现该功能的首选，它可以通过Pip安装：
pip install zeep
安装完成后，关键的下一步是获取WSDL(URL)。SOAP API通常提供WSDL文件，其定义了可用的操作、参数、返回类型等。有了WSDL，zeep可以生成相应的Python类和方法来与SOAP端点进行交互。
获取WSDL
为了与SOAP API通信，首先需要找到WSDL的URL。这个URL是API提供者提供的，它包含了所有必要的API接口说明。
导入zeep
安装完成后，在Python脚本中导入zeep：
from zeep import Client
现在，你已准备好开始与SOAP API交互。
二、创建SOAP客户端
创建SOAP客户，意味着你要初始化与WSDL对应的zeep客户端，这样才能进行API调用。
初始化zeep客户端
使用zeep.Client并传入WSDL的URL来创建客户端：
client = Client('http://example.com?wsdl')
zeep会解析WSDL并提供一个可用来发送请求的服务接口。
浏览可用的操作
zeep允许预览所识别服务的操作列表，这可以通过打印client.service的方式来实现：
print(client.service)
这帮助我们了解可以调用哪些方法以及需要哪些参数。
三、调用SOAP方法
得到客户端和服务的操作列表后，下一步就是发起调用，实际上与API进行交互。
发起一个简单的请求
调用一个SOAP方法很简单，就像在Python中调用一个普通的函数一样。例如，如果API有一个getPrice的方法，可以这样调用：
response = client.service.getPrice('product_id')
这行代码会向SOAP端点发送一个请求并返回响应。
处理复杂的请求
SOAP请求可能涉及复杂的数据结构。zeep通过检查WSDL为这些数据结构生成Python类。使用这些类可以创建必须传递给SOAP方法的复杂类型实例。
factory = client.type_factory('namespace')
product_detAIls = factory.ProductDetails(product_id='123', quantity=2)
response = client.service.getOrderPrice(product_details)
此处，ProductDetails是由zeep从WSDL派生的一个类。
四、处理SOAP响应
一旦发起了一个SOAP调用并得到响应，接下来的任务是解析这些响应数据。
读取简单的响应
简单的响应可以直接读取，例如：
print(response)
通常，zeep将响应解析为易于使用的Python类型。
解析复杂的响应
复杂的响应可能包含嵌套的对象，需要特别处理。利用zeep解析这些响应：
print(response['orderPrice'])
print(response['orderDetails']['product_id'])
使用类似字典的访问可以提取你需要的信息。
五、处理异常
在与API交互过程中，可能会遇到各种错误和异常。正确处理这些情况至关重要。
处理网络问题
网络问题，如连接超时或中断，可能会导致Requests抛出异常。使用try-except语句来捕获这些异常：
from requests.exceptions import Timeout
try:
response = client.service.getPrice('product_id')
except Timeout:
print("The request timed out")
分析SOAP错误
当SOAP端返回错误时，zeep会抛出Fault异常。对此异常进行捕捉可以帮助调试：
from zeep.exceptions import Fault
try:
response = client.service.getPrice('product_id')
except Fault as error:
print(f"SOAP Fault: {error}")
通过捕获这些异常，我们可以优雅地处理错误情况。
六、调试与日志记录
调试SOAP请求可以通过记录zeep生成的XML来进行。
启用XML日志记录
zeep允许启用日志记录，这可以帮助我们查看传出的请求和传入的响应：
import logging
logging.config.dictConfig({
'version': 1,
'formatters': {
'verbose': {
'format': '%(name)s: %(message)s'
},
},
'handlers': {
'console': {
'level': 'DEBUG',
'class': 'logging.StreamHandler',
'formatter': 'verbose',
},
},
'loggers': {
'zeep.transports': {
'level': 'DEBUG',
'propagate': True,
'handlers': ['console'],
},
}
})
这段代码配置了日志记录器，使其打印出所有SOAP HTTP通信的详细信息。
分析XML请求和响应
一旦日志记录启用，每个SOAP请求和响应的XML信息将会显示在终端中，使得调试过程更加透明。
七、结语
使用Python的zeep库与SOAP API交互是一种有效的方式，它提供了一个简单而强大的接口来发送和接收SOAP消息。确保跟踪异常、调试和日志记录，是保证交互顺利进行的关键。通过本指南，你应该能够理解并开始使用Python中的SOAP API。实践这些概念，你将能高效地集成和利用SOAP基础的Web服务。
相关问答FAQs：
如何使用Python进行SOAP API调用？
Python提供了一些库和工具，使您能够轻松地使用SOAP API进行调用。您可以使用库（如suds，zeep或pysimplesoap）来创建SOAP客户端，并使用它来请求和解析SOAP消息。首先，您需要使用WSDL文件初始化客户端，并使用客户端对象发送请求。然后，您可以将请求数据打包到SOAP消息中并发送给API端点。一旦接收到响应，您可以解析并提取所需的数据。
如何处理来自SOAP API的错误和异常？
当使用SOAP API进行调用时，可能会出现各种错误和异常情况。为了正确处理这些情况，您可以在代码中使用适当的异常处理机制。在发起请求之前，您可以检查连接是否可用，并确保API端点处于活动状态。如果在请求期间发生错误，您可以捕获特定的异常并选择适当的错误处理方式。您可以记录错误消息，重试请求或尝试其他备用方案。
除了suds、zeep和pysimplesoap之外，还有其他可用于Python的SOAP库吗？
除了suds、zeep和pysimplesoap之外，还有一些其他可用于Python的SOAP库。例如，SOAPpy是一个受欢迎的选择，它提供了一个简化的接口来创建和发送SOAP请求。另一个库是spyne，它是一个功能强大且易于使用的库，可以用于创建和暴露SOAP服务。您可以根据项目的需求和个人偏好选择适合您的库，并根据库文档中的指南来使用它们。
