Objective-C

Get Populi Access Key (Token)

See more Populi Examples

Demonstrates how to authenticate and obtain an access key using a username and password. Objective-C

#import <CkoRest.h>
#import <NSString.h>
#import <CkoXml.h>

BOOL success = NO;

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

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

// Connect using TLS.
// A single REST object, once connected, can be used for many Populi REST API calls.
// The auto-reconnect indicates that if the already-established HTTPS connection is closed,
// then it will be automatically re-established as needed.
BOOL bAutoReconnect = YES;
success = [rest Connect: @"yourcollege.populi.co" port: [NSNumber numberWithInt: 443] tls: YES autoReconnect: bAutoReconnect];
if (success != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

[rest AddQueryParam: @"username" value: @"POPULI_USERNAME"];
[rest AddQueryParam: @"password" value: @"POPULI_PASSWORD"];

NSString *responseBody = [rest FullRequestFormUrlEncoded: @"POST" uriPath: @"/api/index.php"];
if (rest.LastMethodSuccess != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

// We should expect a 200 response if successful.
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);
    NSLog(@"%@",@"Response Body:");
    NSLog(@"%@",responseBody);
    return;
}

CkoXml *xml = [[CkoXml alloc] init];
[xml LoadXml: responseBody];
NSLog(@"%@",[xml GetXml]);

// Sample response:
// <?xml version="1.0" encoding="ISO-8859-1"?>
// <response>
// <access_key>63481e36023b5d ... 76d0dbc314</access_key>
//     <accountid>19999999</accountid>
//     <accounttype>PERSON</accounttype>
// </response>

// Save the XML to a file for subsequent requests..
[xml SaveXml: @"qa_data/tokens/populi_token.xml"];