使用 Postman 测试 SOAP 接口:从入门到实战_postman调用soap接口
很多开发者习惯用 Postman 测试 REST 接口,却不知道其实 Postman 也能用来调试 SOAP 接口。
SOAP 看起来复杂,其实只要掌握几个点,Postman 一样能轻松搞定。
本篇文章将手把手带你完成一次完整的 SOAP 接口测试流程。
一、准备工作:你需要知道什么?
SOAP 是一种基于 XML 的远程调用协议,而每个 SOAP 接口通常都会有一个 WSDL
地址:
http://example.com/service?wsdl
从这个地址你可以知道:
-
请求方法名(operation)
-
请求结构(input message)
-
返回结构(output message)
-
接口 URL(endpoint)
二、确定请求地址和接口方法
WSDL 中一般包含这些信息:
请求地址就是:
http://example.com/api/WeatherService
你可以用浏览器打开 WSDL 文件,搜索 标签,就能看到方法名,比如:
三、构造 SOAP 请求体(XML)
SOAP 请求结构固定,一般是这样的格式:
Beijing
注意事项:
-
soapenv
是 SOAP 协议用的命名空间 -
tem
是你实际接口的命名空间(在 WSDL 中能查到) -
GetWeather
是请求方法 -
city
是参数名,值为城市名
四、在 Postman 中配置请求
① 新建请求
-
方法:
POST
-
URL:填入 SOAP 接口地址(不是 WSDL 地址)
② 添加 Header
在 Headers 中添加以下字段:
Content-Type
text/xml; charset=utf-8
SOAPAction
\"http://tempuri.org/GetWeather\"
(具体值要从 WSDL 查)注意:SOAPAction
有时必须加双引号,取决于服务端设置。
③ 填写 Body
选择 Body → raw → 类型选择 XML
,将完整的 SOAP 请求 XML 粘进去:
...
点击 Send,即可发送请求。
五、查看响应结果
成功时响应结构也是 XML,大致如下:
Sunny, 28°C
说明调用成功,已拿到结果。
六、常见报错及排查方法
soap:Client
/ soap:Server
报错SOAPAction
头建议结合:
-
WSDL 文件对照参数名和结构
-
SoapUI 工具生成 XML 做参考
七、配合 WSDL 使用的技巧
如果你觉得手动写 XML 太麻烦,可以:
✅ 用 SoapUI 导入 WSDL,生成完整请求 → 拷贝到 Postman
✅ 用浏览器查找请求结构 → Ctrl+C 粘到 Postman 后改参数
✅ 如果公司内部接口,可问开发要一个 XML 示例模板
八、进阶使用:添加认证 / 使用变量
-
如果接口要求认证,可以在 Postman 中添加
Basic Auth
或自定义 Header -
也可以用 Postman 的环境变量,将城市名、token 等参数提取出来方便测试
九、总结
http://.../WeatherService
POST
text/xml; charset=utf-8
\"http://tempuri.org/GetWeather\"
...
🔚 推荐阅读
- 👉 [WSDL 是什么?一篇小白都能懂的 WebService 接口说明书介绍 ]
- 👉 [WebService 入门教程:原理 + 使用流程 + 实战例子,一篇就够 ]
- 👉 [WebService 在企业系统对接中的应用场景 ]