Sample code for 30+ languages & platforms
Perl

Populi Get Roles

See more Populi Examples

Demonstrates the Populi getRoles task.

Chilkat Perl Downloads

Perl
use chilkat();

$success = 0;

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

# First load the previously obtained API token.
# See Get Populi Access Token for sample code showing how to get the API token.
$xml = chilkat::CkXml->new();
$success = $xml->LoadXmlFile("qa_data/tokens/populi_token.xml");
$accessKey = $xml->getChildContent("access_key");
if ($xml->get_LastMethodSuccess() != 1) {
    print "Did not find the access_key" . "\r\n";
    exit;
}

$rest = chilkat::CkRest->new();

# 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.
$bAutoReconnect = 1;
$success = $rest->Connect("yourcollege.populi.co",443,1,$bAutoReconnect);
if ($success != 1) {
    print $rest->lastErrorText() . "\r\n";
    exit;
}

$rest->put_Authorization($accessKey);

$rest->AddQueryParam("task","getRoles");

$responseBody = $rest->fullRequestFormUrlEncoded("POST","/api/index.php");
if ($rest->get_LastMethodSuccess() != 1) {
    print $rest->lastErrorText() . "\r\n";
    exit;
}

# We should expect a 200 response if successful.
if ($rest->get_ResponseStatusCode() != 200) {
    print "Request Header: " . "\r\n";
    print $rest->lastRequestHeader() . "\r\n";
    print "----" . "\r\n";
    print "Response StatusCode = " . $rest->get_ResponseStatusCode() . "\r\n";
    print "Response StatusLine: " . $rest->responseStatusText() . "\r\n";
    print "Response Header:" . "\r\n";
    print $rest->responseHeader() . "\r\n";
    print "Response Body:" . "\r\n";
    print $responseBody . "\r\n";
    exit;
}

$xml->LoadXml($responseBody);
print $xml->getXml() . "\r\n";

# Sample response:
# Use this online tool to generate parsing code from sample XML: 
# Generate Parsing Code from XML

# <?xml version="1.0" encoding="ISO-8859-1"?>
# <response>
#     <role>
#         <id>7</id>
#         <name>Academic Admin</name>
#         <inactive>0</inactive>
#     </role>
#     <role>
#         <id>19</id>
#         <name>Financial Aid</name>
#         <inactive>0</inactive>
#     </role>
#     <role>
#         <id>15</id>
#         <name>Registrar</name>
#         <inactive>0</inactive>
#     </role>
#     <role>
#         <id>4</id>
#         <name>Staff</name>
#         <inactive>0</inactive>
#     </role>
#     <role>
#         <id>1</id>
#         <name>Everyone</name>
#         <inactive>0</inactive>
#     </role>
# </response>

$i = 0;
$count_i = $xml->NumChildrenHavingTag("role");
while ($i < $count_i) {
    $xml->put_I($i);
    $id = $xml->GetChildIntValue("role[i]|id");
    $name = $xml->getChildContent("role[i]|name");
    $inactive = $xml->GetChildIntValue("role[i]|inactive");
    $i = $i + 1;
}