跳到主要内容

soap

soap 插件提供了一种便捷的方法，用于在 RESTful HTTP 请求和 SOAP 请求以及它们对应的响应之间进行转换。

只需一个指向 WSDL 文件的 URL，API7 就会自动解析文件内容并生成转换逻辑，以允许协议转码。

示例​

调用操作​

以下示例演示了如何在路由上配置插件，并调用 WSDL 文件中指定的上游服务器上可用的操作。

创建一个带有 soap 插件的路由：

curl 'http://127.0.0.1:9180/apisix/admin/routes' -X PUT \
  -H 'X-API-KEY: ${ADMIN_API_KEY}' \
  -d '{
    "id": "soap-hello",
    "uri": "/SayHello",
    "methods": ["POST"],
    "plugins": {
      "soap": {
        "wsdl_url": "https://apps.learnwebservices.com/services/hello?wsdl"
      }
    }
  }'

❶ 将 URI 设置为 WSDL 文件中的操作名称。

❷ 仅允许 POST 请求方法。

❸ 设置 WSDL 文件的 URL 路径。

向路由发送请求以进行验证：

curl 'http://127.0.0.1:9080/SayHello' -X POST -d '{"Name": "John Doe"}'

你应该看到带有以下内容的 HTTP/1.1 200 OK 响应：

"Hello John Doe!"