Chilkat HOME .NET Core C# Android™ AutoIt C C# C++ Chilkat2-Python CkPython Classic ASP DataFlex Delphi ActiveX Delphi DLL Go Java Lianja Mono C# Node.js Objective-C PHP ActiveX PHP Extension Perl PowerBuilder PowerShell PureBasic Ruby SQL Server Swift 2 Swift 3,4,5... Tcl Unicode C Unicode C++ VB.NET VBScript Visual Basic 6.0 Visual FoxPro Xojo Plugin
(PHP ActiveX) UPS Address Validation (City, State, Zip)Demonstrates making a call to the UPS address validation REST API.
<?php // This example requires the Chilkat API to have been previously unlocked. // See Global Unlock Sample for sample code. // For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.Http') $http = new COM("Chilkat.Http"); // This is the testing endpoint for address validation: $url = '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. // For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.JsonObject') $json = new COM("Chilkat.JsonObject"); $json->UpdateString('AccessRequest.AccessLicenseNumber','UPS_ACCESS_KEY'); $json->UpdateString('AccessRequest.UserId','UPS_USERNAME'); $json->UpdateString('AccessRequest.Password','UPS_PASSWORD'); $json->UpdateString('AddressValidationRequest.Request.TransactionReference.CustomerContext','Your Customer Context'); $json->UpdateString('AddressValidationRequest.Request.RequestAction','AV'); $json->UpdateString('AddressValidationRequest.Address.City','ALPHARETTA'); // We're making an intentional mistake here by passing CA instead of GA. $json->UpdateString('AddressValidationRequest.Address.StateProvinceCode','CA'); $json->UpdateString('AddressValidationRequest.Address.PostalCode','30005'); // For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.StringBuilder') $sb = new COM("Chilkat.StringBuilder"); // resp is a Chilkat.HttpResponse $resp = $http->PostJson3($url,'application/json',$json); if ($http->LastMethodSuccess != 1) { print $http->LastErrorText . "\n"; exit; } print 'status = ' . $resp->StatusCode . "\n"; // A 200 response status indicate success. if ($resp->StatusCode != 200) { print $resp->BodyStr . "\n"; print 'Failed.' . "\n"; exit; } $json->Load($resp->BodyStr); $json->EmitCompact = 0; print $json->emit() . "\n"; // 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. $numResults = $json->SizeOfArray('AddressValidationResponse.AddressValidationResult'); if ($numResults < 0) { // Here's parse code for the above JSON exact response: $customerContext = $json->stringOf('AddressValidationResponse.Response.TransactionReference.CustomerContext'); $statusCode = $json->stringOf('AddressValidationResponse.Response.ResponseStatusCode'); $statusDescription = $json->stringOf('AddressValidationResponse.Response.ResponseStatusDescription'); $resultRank = $json->stringOf('AddressValidationResponse.AddressValidationResult.Rank'); $resultQuality = $json->stringOf('AddressValidationResponse.AddressValidationResult.Quality'); $city = $json->stringOf('AddressValidationResponse.AddressValidationResult.Address.City'); $provinceCode = $json->stringOf('AddressValidationResponse.AddressValidationResult.Address.StateProvinceCode'); $postalCodeLowEnd = $json->stringOf('AddressValidationResponse.AddressValidationResult.PostalCodeLowEnd'); $postalCodeHighEnd = $json->stringOf('AddressValidationResponse.AddressValidationResult.PostalCodeHighEnd'); print 'Exact match!' . "\n"; print 'postal code: ' . $postalCodeLowEnd . "\n"; } else { print 'Non-Exact match.' . "\n"; $customerContext = $json->stringOf('AddressValidationResponse.Response.TransactionReference.CustomerContext'); $statusCode = $json->stringOf('AddressValidationResponse.Response.ResponseStatusCode'); $statusDescription = $json->stringOf('AddressValidationResponse.Response.ResponseStatusDescription'); $i = 0; while ($i < $numResults) { $json->I = $i; $rank = $json->stringOf('AddressValidationResponse.AddressValidationResult[i].Rank'); print 'rank: ' . $rank . "\n"; $quality = $json->stringOf('AddressValidationResponse.AddressValidationResult[i].Quality'); $addressCity = $json->stringOf('AddressValidationResponse.AddressValidationResult[i].Address.City'); print 'addressCity: ' . $addressCity . "\n"; $addressStateProvinceCode = $json->stringOf('AddressValidationResponse.AddressValidationResult[i].Address.StateProvinceCode'); $postalCodeLowEnd = $json->stringOf('AddressValidationResponse.AddressValidationResult[i].PostalCodeLowEnd'); print 'postal code: ' . $postalCodeLowEnd . "\n"; $postalCodeHighEnd = $json->stringOf('AddressValidationResponse.AddressValidationResult[i].PostalCodeHighEnd'); $i = $i + 1; } } ?> |
© 2000-2024 Chilkat Software, Inc. All Rights Reserved.