(Objective-C) Shippo Validate Address

Demonstrates how to validate your addresses through the Shippo API before you create labels.

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

Chilkat Objective-C Library Downloads MAC OS X (Cocoa) Libs iOS Libs

#import <CkoHttp.h>
#import <CkoHttpRequest.h>
#import <CkoHttpResponse.h>
#import <CkoStringBuilder.h>
#import <CkoJsonObject.h>
#import <NSString.h>

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

CkoHttp *http = [[CkoHttp alloc] init];
BOOL success;

// 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="215 Clayton St." \
//     -d city="San Francisco" \
//     -d state="CA" \
//     -d zip=94117 \
//     -d country="US" \
//     -d email="shippotle@goshippo.com"\
//     -d validate=true

CkoHttpRequest *req = [[CkoHttpRequest alloc] init];
req.HttpVerb = @"POST";
req.Path = @"/addresses/";
req.ContentType = @"application/x-www-form-urlencoded";
[req AddParam: @"name" value: @"Shawn Ippotle"];
[req AddParam: @"company" value: @"Shippo"];
[req AddParam: @"street1" value: @"215 Clayton St."];
[req AddParam: @"city" value: @"San Francisco"];
[req AddParam: @"state" value: @"CA"];
[req AddParam: @"zip" value: @"94117"];
[req AddParam: @"country" value: @"US"];
[req AddParam: @"email" value: @"shippotle@goshippo.com"];
[req AddParam: @"validate" value: @"true"];

[req AddHeader: @"Authorization" value: @"ShippoToken <API_TOKEN>"];

CkoHttpResponse *resp = [http PostUrlEncoded: @"https://api.goshippo.com/addresses/" req: req];
if (http.LastMethodSuccess == NO) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

CkoStringBuilder *sbResponseBody = [[CkoStringBuilder alloc] init];
[resp GetBodySb: sbResponseBody];
CkoJsonObject *jResp = [[CkoJsonObject alloc] init];
[jResp LoadSb: sbResponseBody];
jResp.EmitCompact = NO;

NSLog(@"%@",@"Response Body:");
NSLog(@"%@",[jResp Emit]);

int respStatusCode = [resp.StatusCode intValue];
NSLog(@"%@%d",@"Response Status Code = ",respStatusCode);
if (respStatusCode >= 400) {
    NSLog(@"%@",@"Response Header:");
    NSLog(@"%@",resp.Header);
    NSLog(@"%@",@"Failed.");

    return;
}

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

// {
//   "object_created": "2015-03-30T23:47:11.574Z",
//   "object_updated": "2015-03-30T23:47:11.596Z",
//   "object_id": "67183b2e81e9421f894bfbcdc4236b16",
//   "is_complete": false,
//   "validation_results": {
//     "is_valid": false,
//     "messages": [
//       {
//         "source": "USPS",
//         "code": "Address Not Found",
//         "type": "address_error",
//         "text": "The address as submitted could not be found. Please check for excessive abbreviations in the street address line or in the City name."
//       }
//     ]
//   },
//   "object_owner": "shippotle@goshippo.com",
//   "name": "Shawn Ippotle",
//   "company": "Shippo",
//   "street_no": "",
//   "street1": "215 HIPPO ST.",
//   "street2": "",
//   "city": "SAN FRANCISCO",
//   "state": "CA",
//   "zip": "94107",
//   "country": "US",
//   "phone": ""
// }

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

NSString *source = 0;
NSString *code = 0;
NSString *v_type = 0;
NSString *text = 0;

NSString *object_created = [jResp StringOf: @"object_created"];
NSString *object_updated = [jResp StringOf: @"object_updated"];
NSString *object_id = [jResp StringOf: @"object_id"];
BOOL is_complete = [jResp BoolOf: @"is_complete"];
BOOL validation_resultsIs_valid = [jResp BoolOf: @"validation_results.is_valid"];
NSString *object_owner = [jResp StringOf: @"object_owner"];
NSString *name = [jResp StringOf: @"name"];
NSString *company = [jResp StringOf: @"company"];
NSString *street_no = [jResp StringOf: @"street_no"];
NSString *street1 = [jResp StringOf: @"street1"];
NSString *street2 = [jResp StringOf: @"street2"];
NSString *city = [jResp StringOf: @"city"];
NSString *state = [jResp StringOf: @"state"];
NSString *zip = [jResp StringOf: @"zip"];
NSString *country = [jResp StringOf: @"country"];
NSString *phone = [jResp StringOf: @"phone"];
int i = 0;
int count_i = [[jResp SizeOfArray: @"validation_results.messages"] intValue];
while (i < count_i) {
    jResp.I = [NSNumber numberWithInt: i];
    source = [jResp StringOf: @"validation_results.messages[i].source"];
    code = [jResp StringOf: @"validation_results.messages[i].code"];
    v_type = [jResp StringOf: @"validation_results.messages[i].type"];
    text = [jResp StringOf: @"validation_results.messages[i].text"];
    i = i + 1;
}