AutoIt
UPS Address Validation (City, State, Zip)

Demonstrates making a call to the UPS address validation REST API.
Chilkat AutoIt Downloads

AutoIt
Local $bSuccess = False

; This example requires the Chilkat API to have been previously unlocked.
; See Global Unlock Sample for sample code.

$oHttp = ObjCreate("Chilkat.Http")

; This is the testing endpoint for address validation:
Local $sUrl = "https://wwwcie.ups.com/rest/AV"

; Send an HTTP request with the following JSON body:

; {
;   "AccessRequest": {
;     "AccessLicenseNumber": "Your Access License Number",
;     "UserId": "Your Username",
;     "Password": "Your Password"
;   },
;   "AddressValidationRequest": {
;     "Request": {
;       "TransactionReference": {
;         "CustomerContext": "Your Customer Context"
;       },
;       "RequestAction": "AV"
;     },
;     "Address": {
;       "City": "ALPHARETTA",
;       "StateProvinceCode": "GA",
;       "PostalCode": "30005"
;     }
;   }
; }

; Build the above JSON.
$oJson = ObjCreate("Chilkat.JsonObject")
$oJson.UpdateString("AccessRequest.AccessLicenseNumber","UPS_ACCESS_KEY")
$oJson.UpdateString("AccessRequest.UserId","UPS_USERNAME")
$oJson.UpdateString("AccessRequest.Password","UPS_PASSWORD")
$oJson.UpdateString("AddressValidationRequest.Request.TransactionReference.CustomerContext","Your Customer Context")
$oJson.UpdateString("AddressValidationRequest.Request.RequestAction","AV")
$oJson.UpdateString("AddressValidationRequest.Address.City","ALPHARETTA")
; We're making an intentional mistake here by passing CA instead of GA.
$oJson.UpdateString("AddressValidationRequest.Address.StateProvinceCode","CA")
$oJson.UpdateString("AddressValidationRequest.Address.PostalCode","30005")

$oSb = ObjCreate("Chilkat.StringBuilder")
$oResp = ObjCreate("Chilkat.HttpResponse")
$bSuccess = $oHttp.HttpJson("POST",$sUrl,$oJson,"application/json",$oResp)
If ($bSuccess = False) Then
    ConsoleWrite($oHttp.LastErrorText & @CRLF)
    Exit
EndIf

ConsoleWrite("status = " & $oResp.StatusCode & @CRLF)

; A 200 response status indicate success.
If ($oResp.StatusCode <> 200) Then
    ConsoleWrite($oResp.BodyStr & @CRLF)
    ConsoleWrite("Failed." & @CRLF)
    Exit
EndIf

$oJson.Load($oResp.BodyStr)
$oJson.EmitCompact = False
ConsoleWrite($oJson.Emit() & @CRLF)

; A successful exact response looks like this:

; {
;   "AddressValidationResponse": {
;     "Response": {
;       "TransactionReference": {
;         "CustomerContext": "Your Customer Context"
;       },
;       "ResponseStatusCode": "1",
;       "ResponseStatusDescription": "Success"
;     },
;     "AddressValidationResult": {
;       "Rank": "1",
;       "Quality": "1.0",
;       "Address": {
;         "City": "ALPHARETTA",
;         "StateProvinceCode": "GA"
;       },
;       "PostalCodeLowEnd": "30005",
;       "PostalCodeHighEnd": "30005"
;     }
;   }
; }
; 

; A successful response that was not an exact match provides an array of closest matches, like this:

; {
;   "AddressValidationResponse": {
;     "Response": {
;       "TransactionReference": {
;         "CustomerContext": "Your Customer Context"
;         "Quality": "0.9875",
;         "Address": {
;       },
;       "ResponseStatusCode": "1",
;       "ResponseStatusDescription": "Success"
;     },
;     "AddressValidationResult": [
;       {
;         "Rank": "1",
;           "City": "ALPHARETTA",
;           "StateProvinceCode": "GA"
;         },
;         "PostalCodeLowEnd": "30005",
;         "PostalCodeHighEnd": "30005"
;       },
;       {
;         "Rank": "2",
;         "Quality": "0.9750",
;         "Address": {
;           "City": "ALPHARETTA",
;           "StateProvinceCode": "GA"
;         },
;         "PostalCodeLowEnd": "30004",
;         "PostalCodeHighEnd": "30004"
;       },
;       {
;         "Rank": "3",
;         "Quality": "0.9750",
;         "Address": {
;           "City": "ALPHARETTA",
;           "StateProvinceCode": "GA"
;         },
;         "PostalCodeLowEnd": "30009",
;         "PostalCodeHighEnd": "30009"
;       }
;     ]
;   }
; }

; Use the online tool at Generate JSON Parsing Code
; to generate JSON parsing code.

Local $sCustomerContext
Local $statusCode
Local $statusDescription
Local $sResultRank
Local $sResultQuality
Local $sCity
Local $sProvinceCode
Local $sPostalCodeLowEnd
Local $sPostalCodeHighEnd
Local $sRank
Local $sQuality
Local $sAddressCity
Local $sAddressStateProvinceCode

Local $iNumResults = $oJson.SizeOfArray("AddressValidationResponse.AddressValidationResult")
If ($iNumResults < 0) Then

    ; Here's parse code for the above JSON exact response:
    $sCustomerContext = $oJson.StringOf("AddressValidationResponse.Response.TransactionReference.CustomerContext")
    $statusCode = $oJson.StringOf("AddressValidationResponse.Response.ResponseStatusCode")
    $statusDescription = $oJson.StringOf("AddressValidationResponse.Response.ResponseStatusDescription")
    $sResultRank = $oJson.StringOf("AddressValidationResponse.AddressValidationResult.Rank")
    $sResultQuality = $oJson.StringOf("AddressValidationResponse.AddressValidationResult.Quality")
    $sCity = $oJson.StringOf("AddressValidationResponse.AddressValidationResult.Address.City")
    $sProvinceCode = $oJson.StringOf("AddressValidationResponse.AddressValidationResult.Address.StateProvinceCode")
    $sPostalCodeLowEnd = $oJson.StringOf("AddressValidationResponse.AddressValidationResult.PostalCodeLowEnd")
    $sPostalCodeHighEnd = $oJson.StringOf("AddressValidationResponse.AddressValidationResult.PostalCodeHighEnd")

    ConsoleWrite("Exact match!" & @CRLF)
    ConsoleWrite("postal code: " & $sPostalCodeLowEnd & @CRLF)

Else

    ConsoleWrite("Non-Exact match." & @CRLF)

    $sCustomerContext = $oJson.StringOf("AddressValidationResponse.Response.TransactionReference.CustomerContext")
    $statusCode = $oJson.StringOf("AddressValidationResponse.Response.ResponseStatusCode")
    $statusDescription = $oJson.StringOf("AddressValidationResponse.Response.ResponseStatusDescription")
Local $i = 0
    While $i < $iNumResults
        $oJson.I = $i
        $sRank = $oJson.StringOf("AddressValidationResponse.AddressValidationResult[i].Rank")
        ConsoleWrite("rank: " & $sRank & @CRLF)
        $sQuality = $oJson.StringOf("AddressValidationResponse.AddressValidationResult[i].Quality")
        $sAddressCity = $oJson.StringOf("AddressValidationResponse.AddressValidationResult[i].Address.City")
        ConsoleWrite("addressCity: " & $sAddressCity & @CRLF)
        $sAddressStateProvinceCode = $oJson.StringOf("AddressValidationResponse.AddressValidationResult[i].Address.StateProvinceCode")
        $sPostalCodeLowEnd = $oJson.StringOf("AddressValidationResponse.AddressValidationResult[i].PostalCodeLowEnd")
        ConsoleWrite("postal code: " & $sPostalCodeLowEnd & @CRLF)
        $sPostalCodeHighEnd = $oJson.StringOf("AddressValidationResponse.AddressValidationResult[i].PostalCodeHighEnd")
        $i = $i + 1
    Wend
EndIf