Get Postal Codes - addressing - Spectrum_OnDemand - web_services - 23 - 23.1

Spectrum-Webdienste-Handbuch
Product type
Software
Portfolio
Integrate
Product family
Spectrum™ software
Product
Spectrum™ software > Web Services
Version
23.1
ft:locale
de-DE
Product name
Spectrum Technology Platform
ft:title
Spectrum-Webdienste-Handbuch
First publish date
2007
ft:lastEdition
2023-10-25
ft:lastPublication
2023-10-25T07:20:03.279000

Mit Get Postal Codes können Sie die Postleitzahlen für einen bestimmten Ort nachschlagen. Der Dienst akzeptiert Ort, Bundesland/Kanton und Land als Eingabe und gibt die Postleitzahlen für diesen Ort zurück. Die Eingabe muss korrekt sein, damit Postleitzahlen zurückgegeben werden.

Anmerkung: Get Postal Codes funktioniert nur mit US-Adressen.

Get Postal Codes ist Teil von Spectrum Universal Address.

Ressourcen-URL

JSON-Endpunkt: 

http://server:port/rest/GetPostalCodes/results.json
https://OnDemandServer/rest/GetPostalCodes/results.json

XML-Endpunkt: 

http://server:port/rest/GetPostalCodes/results.xml
https://OnDemandServer/rest/GetPostalCodes/results.xml
http://server:port/soap/GetPostalCodes
https://OnDemandServer/soap/GetPostalCodes

Eine Liste der Spectrum Technology Platform-Server finden Sie unter Herstellen einer Verbindung zu -Servern.

Beispiel mit JSON-Antwort

Im folgenden Beispiel wird eine JSON-Antwort angefordert:

http://myserver:8080/rest/GetPostalCodes/results.json?​Data.City=Holland&Data.StateProvince=MI
https://spectrum.precisely.com/rest/GetPostalCodes/results.json?​Data.City=Holland&Data.StateProvince=MI

Die von dieser Anforderung zurückgegebene JSON-Antwort würde wie folgt lauten:

{"output_port": [       {       "ProcessedBy": "USA",       "PostalCode": "49422",       "Status": "",       "City.Type": " ",       "Status.Code": "",       "Status.Description": "",       "user_fields": []    },       {       "ProcessedBy": "USA",       "PostalCode": "49423",       "Status": "",       "City.Type": " ",       "Status.Code": "",       "Status.Description": "",       "user_fields": []    },       {       "ProcessedBy": "USA",       "PostalCode": "49424",       "Status": "",       "City.Type": " ",       "Status.Code": "",       "Status.Description": "",       "user_fields": []    } ]}

Beispiel mit XML-Antwort

Im folgenden Beispiel wird eine XML-Antwort angefordert:

http://myserver:8080/rest/GetPostalCodes/results.xml?Data.City=Holland&​Data.StateProvince=MI
https://spectrum.precisely.com/rest/GetPostalCodes/results.xml?Data.City=Holland&​Data.StateProvince=MI

Die von dieser Anforderung zurückgegebene XML-Antwort würde wie folgt lauten:

<ns2:xml.GetPostalCodesResponse xmlns:ns2="http://www.pb.com/spectrum/services/GetPostalCodes">    <ns2:output_port>       <ns2:Result>          <ns2:ProcessedBy>USA</ns2:ProcessedBy>          <ns2:PostalCode>49422</ns2:PostalCode>          <ns2:City.Type></ns2:City.Type>          <ns2:Status/>          <ns2:Status.Code/>          <ns2:Status.Description/>          <ns2:user_fields/>       </ns2:Result>       <ns2:Result>          <ns2:ProcessedBy>USA</ns2:ProcessedBy>          <ns2:PostalCode>49423</ns2:PostalCode>          <ns2:City.Type></ns2:City.Type>          <ns2:Status/>          <ns2:Status.Code/>          <ns2:Status.Description/>          <ns2:user_fields/>       </ns2:Result>       <ns2:Result>          <ns2:ProcessedBy>USA</ns2:ProcessedBy>          <ns2:PostalCode>49424</ns2:PostalCode>          <ns2:City.Type></ns2:City.Type>          <ns2:Status/>          <ns2:Status.Code/>          <ns2:Status.Description/>          <ns2:user_fields/>       </ns2:Result>    </ns2:output_port> </ns2:xml.GetPostalCodesResponse>

Beispiel

Im Folgenden wird eine SOAP-Anforderung dargestellt:

<soapenv:Envelope 	xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 	xmlns:get="http://www.pb.com/spectrum/services/GetPostalCodes"> 	<soapenv:Header/> 	<soapenv:Body> 		<get:GetPostalCodesRequest> 			<get:input_port> 				<get:Input> 					<!--Optional:--> 					<get:City>Holland</get:City> 					<!--Optional:--> 					<get:StateProvince>MI</get:StateProvince> 					<!--Optional:--> 					<get:Country></get:Country> 					<!--Optional:--> 					<get:user_fields> 						<get:user_field> 							<get:name>?</get:name> 							<get:value>?</get:value> 						</get:user_field> 					</get:user_fields> 				</get:Input> 			</get:input_port> 		</get:GetPostalCodesRequest> 	</soapenv:Body> </soapenv:Envelope>

Dies wäre die Antwort:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">    <soap:Body>       <ns3:GetPostalCodesResponse xmlns:ns2="http://spectrum.pb.com/" ​xmlns:ns3="http://www.pb.com/spectrum/services/GetPostalCodes">          <ns3:output_port>             <ns3:Result>                <ns3:ProcessedBy>USA</ns3:ProcessedBy>                <ns3:PostalCode>49422</ns3:PostalCode>                <ns3:City.Type></ns3:City.Type>                <ns3:Status/>                <ns3:Status.Code/>                <ns3:Status.Description/>                <ns3:user_fields/>             </ns3:Result>             <ns3:Result>                <ns3:ProcessedBy>USA</ns3:ProcessedBy>                <ns3:PostalCode>49423</ns3:PostalCode>                <ns3:City.Type></ns3:City.Type>                <ns3:Status/>                <ns3:Status.Code/>                <ns3:Status.Description/>                <ns3:user_fields/>             </ns3:Result>             <ns3:Result>                <ns3:ProcessedBy>USA</ns3:ProcessedBy>                <ns3:PostalCode>49424</ns3:PostalCode>                <ns3:City.Type></ns3:City.Type>                <ns3:Status/>                <ns3:Status.Code/>                <ns3:Status.Description/>                <ns3:user_fields/>             </ns3:Result>          </ns3:output_port>       </ns3:GetPostalCodesResponse>    </soap:Body> </soap:Envelope>