(Perl) Populi Add Financial Aid Disbursement

Demonstrates the Populi addFinancialAidDisbursement task.

Chilkat Perl Downloads Perl Module for Windows, MacOS, Linux, Alpine Linux, Solaris

use chilkat();

# 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","addFinancialAidDisbursement");
$rest->AddQueryParam("person_id","12345678");
$rest->AddQueryParam("award_id","555555");
$rest->AddQueryParam("academic_term_id","123");
$rest->AddQueryParam("scheduled_date","2019-10-10");
$rest->AddQueryParam("amount","12345");

$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="UTF-8"?>
# <result>
# 	<disbursement>123456</disbursement>
# </result>

$disbursement = $xml->GetChildIntValue("disbursement");