在Python中使用SOAP API的指南

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服务。您可以根据项目的需求和个人偏好选择适合您的库，并根据库文档中的指南来使用它们。

最后建议，企业在引入信息化系统初期，切记要合理有效地运用好工具，这样一来不仅可以让公司业务高效地运行，还能最大程度保证团队目标的达成。同时还能大幅缩短系统开发和部署的时间成本。特别是有特定需求功能需要定制化的企业，可以采用我们公司自研的企业级低代码平台：织信Informat。 织信平台基于数据模型优先的设计理念，提供大量标准化的组件，内置AI助手、组件设计器、自动化（图形化编程）、脚本、工作流引擎（BPMN2.0）、自定义API、表单设计器、权限、仪表盘等功能，能帮助企业构建高度复杂核心的数字化系统。如ERP、MES、CRM、PLM、SCM、WMS、项目管理、流程管理等多个应用场景，全面助力企业落地国产化/信息化/数字化转型战略目标。 版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们微信：Informat_5 处理，核实后本网站将在24小时内删除。