Objective-C

GeoOp - Create Client

See more GeoOp Examples

Creates a new client. Objective-C

#import <CkoJsonObject.h>
#import <CkoOAuth2.h>
#import <CkoRest.h>
#import <NSString.h>

BOOL success = NO;

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

//  This example also assumes an OAuth2 access token was previously fetched.
//  and saved in a JSON file.  

//  First get our previously obtained access token.
//  {"access_token":"e6dqdG....mzjpT04w==","token_type":"Bearer","expires_in":2592000,"owner_id":999236}
CkoJsonObject *jsonToken = [[CkoJsonObject alloc] init];
success = [jsonToken LoadFile: @"qa_data/tokens/geoop.json"];

//  This example assumes we previously obtained an access token
CkoOAuth2 *oauth2 = [[CkoOAuth2 alloc] init];
oauth2.AccessToken = [jsonToken StringOf: @"access_token"];

CkoRest *rest = [[CkoRest alloc] init];

//  Connect to GeoOp..
//  Note: The same REST object, once connected, can be used for many requests.
//  The bAutoReconnect argument allows it to automatically reconnect as required for any subsequent request.

BOOL bAutoReconnect = YES;
success = [rest Connect: @"api.geoop.com" port: [NSNumber numberWithInt: 443] tls: YES autoReconnect: bAutoReconnect];
if (success != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

//  Provide the authentication credentials (i.e. the access token)
[rest SetAuthOAuth2: oauth2];

//  Set the X-Version header.
[rest AddHeader: @"X-Version" value: @"1.0"];

//  To create a new client, we can build and send the following JSON:
//  	{
//  	  "clients": [
//  	    {
//  	      "firstName": "Joe",
//  	      "lastName": "Miller",
//  	      "companyName": "Miller Bakery",
//  	      "businessType": "Licensed Bakery",
//  	      "account": {
//  	        "id": 39409
//  	      },
//  	      "address": {
//  	        "line1": "1832 Pennsylvania Avenue NW",
//  	        "city": "Washington",
//  	        "postcode": "20006",
//  	      }
//  	    }
//  	}

CkoJsonObject *jsonClient = [[CkoJsonObject alloc] init];
[jsonClient UpdateInt: @"clients[0].account.id" value: [NSNumber numberWithInt: 39409]];
[jsonClient UpdateString: @"clients[0].firstName" value: @"Joe"];
[jsonClient UpdateString: @"clients[0].lastName" value: @"Miller"];
[jsonClient UpdateString: @"clients[0].companyName" value: @"Miller Bakery"];
[jsonClient UpdateString: @"clients[0].businessType" value: @"Licensed Bakery"];
[jsonClient UpdateString: @"clients[0].address.line1" value: @"1832 Pennsylvania Avenue NW"];
[jsonClient UpdateString: @"clients[0].address.city" value: @"Washington"];
[jsonClient UpdateString: @"clients[0].address.postcode" value: @"20006"];

//  Examine the JSON we're about to send...
jsonClient.EmitCompact = NO;
NSLog(@"%@",[jsonClient Emit]);

[rest AddHeader: @"Content-Type" value: @"application/json"];

jsonClient.EmitCompact = YES;
NSString *responseBody = [rest FullRequestString: @"POST" uriPath: @"/clients" bodyText: [jsonClient Emit]];
if (rest.LastMethodSuccess != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

CkoJsonObject *json = [[CkoJsonObject alloc] init];
json.EmitCompact = NO;

//  If the response status code did not indicate success, then see what happened..
if ([rest.ResponseStatusCode intValue] != 200) {
    NSLog(@"%@",@"Request Header: ");
    NSLog(@"%@",rest.LastRequestHeader);
    NSLog(@"%@",@"----");
    NSLog(@"%@%d",@"Response StatusCode = ",[rest.ResponseStatusCode intValue]);
    NSLog(@"%@%@",@"Response StatusLine: ",rest.ResponseStatusText);
    NSLog(@"%@",@"Response Header:");
    NSLog(@"%@",rest.ResponseHeader);
    [json Load: responseBody];
    NSLog(@"%@",[json Emit]);
    return;
}

[json Load: responseBody];
//  Show the full JSON response..
NSLog(@"%@",[json Emit]);

//  The success JSON looks like this:

//  	{
//  	  "result": "success",
//  	  "clients": [
//  	    {
//  	      "id": 9571218,
//  	      "firstName": "Joe",
//  	      "lastName": "Miller",
//  	      "companyName": "Miller Bakery",
//  	      "businessType": "Licensed Bakery",
//  	      "leadSource": "",
//  	      "emailAddress": null,
//  	      "phoneNumber": null,
//  	      "mobileNumber": null,
//  	      "faxNumber": null,
//  	      "notes": "",
//  	      "deleted": false,
//  	      "hasRecentJobs": false,
//  	      "created": "2016-10-31T13:02:07+00:00",
//  	      "modified": "2016-10-31T13:02:07+00:00",
//  	      "billingClient": null,
//  	      "account": {
//  	        "id": 39409
//  	      },
//  	      "address": {
//  	        "line1": "1832 Pennsylvania Avenue NW",
//  	        "line2": "",
//  	        "city": "Washington",
//  	        "postcode": "20006",
//  	        "latitude": 0,
//  	        "longitude": 0
//  	      },
//  	      "mailingAddress": {
//  	        "line1": "",
//  	        "line2": "",
//  	        "city": ""
//  	      }
//  	    }
//  	  ],
//  	  "metadata": {
//  	    "receivedItemsCount": 1,
//  	    "validItems": [
//  	      0
//  	    ],
//  	    "invalidItems": [
//  	    ]
//  	  }
//  	}
//  
//