ChinaZipSearchWebService Web 服务

ChinaZipSearchWebService

单击此处，获取完整的操作列表。

getZipCodeByAddress

通过省份、城市、地址查询本邮政编码查询Web Services支持邮政编码数据

输入参数：theProvinceName = 省份/直辖市（必须按照 getSupportProvince 输入），theCityName = 城市、地区，theAddress = 街道、乡镇，userID = 商业用户ID（普通用户不需要），theProvinceName若为空则默认上海，支持模糊查询，免费用户最多输出20条相关数据（如需显示更多请联系我们）；返回数据：DataSet，结构为：Item.(ADDRESS)=街道、乡镇，Item.(CITY)=城市、地区，Item.(PROVINCE)=省份/直辖市，Item.(ZIP)=邮政编码。

测试

若要使用 HTTP POST 协议对操作进行测试，请单击“调用”按钮。

参数	值
theProvinceName:
theCityName:
theAddress:
userID:

SOAP 1.1

以下是 SOAP 1.2 请求和响应示例。所显示的占位符需替换为实际值。

POST /WebServices/ChinaZipSearchWebService.asmx HTTP/1.1
Host: ws.webxml.com.cn
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://WebXml.com.cn/getZipCodeByAddress"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <getZipCodeByAddress xmlns="http://WebXml.com.cn/">
      <theProvinceName>string</theProvinceName>
      <theCityName>string</theCityName>
      <theAddress>string</theAddress>
      <userID>string</userID>
    </getZipCodeByAddress>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <getZipCodeByAddressResponse xmlns="http://WebXml.com.cn/">
      <getZipCodeByAddressResult>
        <xsd:schema>schema</xsd:schema>xml</getZipCodeByAddressResult>
    </getZipCodeByAddressResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

以下是 SOAP 1.2 请求和响应示例。所显示的占位符需替换为实际值。

POST /WebServices/ChinaZipSearchWebService.asmx HTTP/1.1
Host: ws.webxml.com.cn
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <getZipCodeByAddress xmlns="http://WebXml.com.cn/">
      <theProvinceName>string</theProvinceName>
      <theCityName>string</theCityName>
      <theAddress>string</theAddress>
      <userID>string</userID>
    </getZipCodeByAddress>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <getZipCodeByAddressResponse xmlns="http://WebXml.com.cn/">
      <getZipCodeByAddressResult>
        <xsd:schema>schema</xsd:schema>xml</getZipCodeByAddressResult>
    </getZipCodeByAddressResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP GET

以下是 HTTP GET 请求和响应示例。所显示的占位符需替换为实际值。

GET /WebServices/ChinaZipSearchWebService.asmx/getZipCodeByAddress?theProvinceName=string&theCityName=string&theAddress=string&userID=string HTTP/1.1
Host: ws.webxml.com.cn

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<DataSet xmlns="http://WebXml.com.cn/">
  <schema xmlns="http://www.w3.org/2001/XMLSchema">schema</schema>xml</DataSet>

HTTP POST

以下是 HTTP POST 请求和响应示例。所显示的占位符需替换为实际值。

POST /WebServices/ChinaZipSearchWebService.asmx/getZipCodeByAddress HTTP/1.1
Host: ws.webxml.com.cn
Content-Type: application/x-www-form-urlencoded
Content-Length: length

theProvinceName=string&theCityName=string&theAddress=string&userID=string

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<DataSet xmlns="http://WebXml.com.cn/">
  <schema xmlns="http://www.w3.org/2001/XMLSchema">schema</schema>xml</DataSet>