关于Vertafore AMS360 WSAPI的SOAP参数传递及登录404问题咨询

问题背景 #

• 对SOAP API不熟悉，需使用Vertafore AMS360的WSAPI，已获取官方文档（API概述、WSDL下载、API参考指南），最初无法理解AgencyInfoGet等请求的参数传递方式，官方未提供完整示例。
• 2024年2月12日更新：学习SOAP API课程后仍无法调用API，按官方登录请求示例在Postman中配置后，返回404-文件或目录未找到错误，已确认替换REPLACE_ME为正确值，问题聚焦于端点访问失败。

官方登录请求示例 #

THIS CALL IS TO LOGIN

POST https://wsapi.ams360.com/v3/WSAPIService.svc HTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://www.WSAPI.AMS360.com/v3.0/WSAPIServiceContract/Login"
Host: wsapi.ams360.com
Content-Length: 409
Expect: 100-continue
Accept-Encoding: gzip, deflate
Connection: Keep-Alive

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <Login xmlns="http://www.WSAPI.AMS360.com/v3.0">
            <Request xmlns:a="http://www.WSAPI.AMS360.com/v3.0/DataContract" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:AgencyNo>REPLACE_ME</a:AgencyNo>
                <a:LoginId>REPLACE_ME</a:LoginId>
                <a:Password>REPLACE_ME</a:Password>
                <a:EmployeeCode/>
            </Request>
        </Login>
    </s:Body>
</s:Envelope>

我的Postman配置 #

请求信息 #

POST https://wsapi.ams360.com/v3/WSAPIService.svc HTTP/1

请求头 #

Content-Type: text/xml; charset=utf-8
SOAPAction: "http://www.WSAPI.AMS360.com/v3.0/WSAPIServiceContract/Login"

请求体 #

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <Login xmlns="http://www.WSAPI.AMS360.com/v3.0">
        <Request xmls:a="http://www.WSAPI.AMS360.com/v3.0/DataContract" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <a:AgencyNo>REPLACE_ME</a:AgencyNo>
            <a:LoginId>REPLACE_ME</a:LoginId>
            <a:Password>REPLACE_ME</a:Password>
            <a:EmployeeCode/>
        </Request>
    </Login>
  </soap:Body>
</soap:Envelope>

排查方向 #

• HTTP版本问题：官方示例使用HTTP/1.1，你的Postman请求写的是HTTP/1，部分服务器不兼容HTTP/1，建议改为HTTP/1.1。
• 命名空间拼写错误：请求体里的xmls:a是拼写错误，正确应为xmlns:a，这个错误可能导致服务器无法解析请求结构，进而返回404（部分服务会因请求格式错误返回404而非400）。
• 端点路径验证：确认Vertafore WSAPI的v3版本端点是否确实是/v3/WSAPIService.svc，可通过WSDL文件验证服务地址（打开WSDL搜索location属性）。
• 请求头完整性：官方示例包含Host、Accept-Encoding等头，虽然部分头不是必填，但可尝试添加完整头信息，避免服务器因头信息不全拒绝请求。
• SSL/TLS配置：确认Postman使用的SSL/TLS版本是否符合Vertafore服务器要求，部分旧版本TLS可能被拦截，导致请求无法到达正确端点。

内容的提问来源于stack exchange，提问作者Clayton Ritchey