(Delphi DLL) Shippo Validate Global Address

Demonstrates how to validate a global address.

For more information, see https://goshippo.com/docs/address-validation/

Chilkat for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Http, HttpRequest, HttpResponse, StringBuilder, JsonObject;

...

procedure TForm1.Button1Click(Sender: TObject);
var
http: HCkHttp;
success: Boolean;
req: HCkHttpRequest;
resp: HCkHttpResponse;
sbResponseBody: HCkStringBuilder;
jResp: HCkJsonObject;
respStatusCode: Integer;
source: PWideChar;
v_type: PWideChar;
code: PWideChar;
text: PWideChar;
object_created: PWideChar;
object_updated: PWideChar;
object_id: PWideChar;
is_complete: Boolean;
validation_resultsIs_valid: Boolean;
object_owner: PWideChar;
name: PWideChar;
company: PWideChar;
street_no: PWideChar;
street1: PWideChar;
street2: PWideChar;
street3: PWideChar;
city: PWideChar;
state: PWideChar;
zip: PWideChar;
country: PWideChar;
longitude: PWideChar;
latitude: PWideChar;
phone: PWideChar;
email: PWideChar;
is_residential: PWideChar;
metadata: PWideChar;
test: Boolean;
i: Integer;
count_i: Integer;

begin
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

http := CkHttp_Create();

// Implements the following CURL command:

// curl https://api.goshippo.com/addresses/ \
//     -H "Authorization: ShippoToken <API_TOKEN>" \
//     -d name="Shawn Ippotle" \
//     -d company="Shippo" \
//     -d street1="Kortrijksesteenweg 1005" \
//     -d city="Gent" \
//     -d zip=9000 \
//     -d country="BE" \
//     -d email="shippotle@goshippo.com"\
//     -d validate=true

req := CkHttpRequest_Create();
CkHttpRequest_putHttpVerb(req,'POST');
CkHttpRequest_putPath(req,'/addresses/');
CkHttpRequest_putContentType(req,'application/x-www-form-urlencoded');
CkHttpRequest_AddParam(req,'name','Shawn Ippotle');
CkHttpRequest_AddParam(req,'company','Shippo');
CkHttpRequest_AddParam(req,'street1','Kortrijksesteenweg 1005');
CkHttpRequest_AddParam(req,'city','Gent');
CkHttpRequest_AddParam(req,'zip','9000');
CkHttpRequest_AddParam(req,'country','BE');
CkHttpRequest_AddParam(req,'email','shippotle@goshippo.com');
CkHttpRequest_AddParam(req,'validate','true');

CkHttpRequest_AddHeader(req,'Authorization','ShippoToken <API_TOKEN>');

resp := CkHttp_PostUrlEncoded(http,'https://api.goshippo.com/addresses/',req);
if (CkHttp_getLastMethodSuccess(http) = False) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Exit;
  end;

sbResponseBody := CkStringBuilder_Create();
CkHttpResponse_GetBodySb(resp,sbResponseBody);
jResp := CkJsonObject_Create();
CkJsonObject_LoadSb(jResp,sbResponseBody);
CkJsonObject_putEmitCompact(jResp,False);

Memo1.Lines.Add('Response Body:');
Memo1.Lines.Add(CkJsonObject__emit(jResp));

respStatusCode := CkHttpResponse_getStatusCode(resp);
Memo1.Lines.Add('Response Status Code = ' + IntToStr(respStatusCode));
if (respStatusCode >= 400) then
  begin
    Memo1.Lines.Add('Response Header:');
    Memo1.Lines.Add(CkHttpResponse__header(resp));
    Memo1.Lines.Add('Failed.');
    CkHttpResponse_Dispose(resp);
    Exit;
  end;
CkHttpResponse_Dispose(resp);

// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)

// {
//   "object_created": "2017-07-26T17:52:37.305Z",
//   "object_updated": "2017-07-26T17:52:37.351Z",
//   "object_id": "b7f9709df3914d1ca6efe4c30e7b0572",
//   "is_complete": true,
//   "validation_results": {
//     "is_valid": true,
//     "messages": [
//       {
//         "source": "Shippo Address Validator",
//         "type": "address_correction",
//         "code": "administrative_area_change",
//         "text": "The administrative area (state or province) was added or changed."
//       },
//       {
//         "source": "Shippo Address Validator",
//         "code": "geocoded_rooftop",
//         "text": "The record was geocoded down to rooftop level, meaning the point is within the property boundaries (most often the center)."
//       },
//       {
//         "source": "Shippo Address Validator",
//         "code": "premises_full",
//         "text": "The address has been verified to the Premise (House or Building) Level, which is the highest level possible with the reference data."
//       }
//     ]
//   },
//   "object_owner": "hippo@goshippo.com",
//   "name": "Hippo Shippo",
//   "company": "Shippo",
//   "street_no": "2",
//   "street1": "Unter den Linden",
//   "street2": "",
//   "street3": "",
//   "city": "Berlin",
//   "state": "",
//   "zip": "10117",
//   "country": "DE",
//   "longitude": "13.39751",
//   "latitude": "52.51785",
//   "phone": "14151234567",
//   "email": "hippo@goshippo.com",
//   "is_residential": null,
//   "metadata": "",
//   "test": false
// }

// Sample code for parsing the JSON response...
// Use the following online tool to generate parsing code from sample JSON:
// Generate Parsing Code from JSON

object_created := CkJsonObject__stringOf(jResp,'object_created');
object_updated := CkJsonObject__stringOf(jResp,'object_updated');
object_id := CkJsonObject__stringOf(jResp,'object_id');
is_complete := CkJsonObject_BoolOf(jResp,'is_complete');
validation_resultsIs_valid := CkJsonObject_BoolOf(jResp,'validation_results.is_valid');
object_owner := CkJsonObject__stringOf(jResp,'object_owner');
name := CkJsonObject__stringOf(jResp,'name');
company := CkJsonObject__stringOf(jResp,'company');
street_no := CkJsonObject__stringOf(jResp,'street_no');
street1 := CkJsonObject__stringOf(jResp,'street1');
street2 := CkJsonObject__stringOf(jResp,'street2');
street3 := CkJsonObject__stringOf(jResp,'street3');
city := CkJsonObject__stringOf(jResp,'city');
state := CkJsonObject__stringOf(jResp,'state');
zip := CkJsonObject__stringOf(jResp,'zip');
country := CkJsonObject__stringOf(jResp,'country');
longitude := CkJsonObject__stringOf(jResp,'longitude');
latitude := CkJsonObject__stringOf(jResp,'latitude');
phone := CkJsonObject__stringOf(jResp,'phone');
email := CkJsonObject__stringOf(jResp,'email');
is_residential := CkJsonObject__stringOf(jResp,'is_residential');
metadata := CkJsonObject__stringOf(jResp,'metadata');
test := CkJsonObject_BoolOf(jResp,'test');
i := 0;
count_i := CkJsonObject_SizeOfArray(jResp,'validation_results.messages');
while i < count_i do
  begin
    CkJsonObject_putI(jResp,i);
    source := CkJsonObject__stringOf(jResp,'validation_results.messages[i].source');
    v_type := CkJsonObject__stringOf(jResp,'validation_results.messages[i].type');
    code := CkJsonObject__stringOf(jResp,'validation_results.messages[i].code');
    text := CkJsonObject__stringOf(jResp,'validation_results.messages[i].text');
    i := i + 1;
  end;

CkHttp_Dispose(http);
CkHttpRequest_Dispose(req);
CkStringBuilder_Dispose(sbResponseBody);
CkJsonObject_Dispose(jResp);

end;