(PowerShell) Get Populi Access Key (Token)

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

Chilkat .NET Downloads Chilkat .NET Assemblies

Add-Type -Path "C:\chilkat\ChilkatDotNet47-9.5.0-x64\ChilkatDotNet47.dll"

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

$rest = New-Object Chilkat.Rest

# 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 = $true
$success = $rest.Connect("yourcollege.populi.co",443,$true,$bAutoReconnect)
if ($success -ne $true) {
    $($rest.LastErrorText)
    exit
}

$rest.AddQueryParam("username","POPULI_USERNAME")
$rest.AddQueryParam("password","POPULI_PASSWORD")

$responseBody = $rest.FullRequestFormUrlEncoded("POST","/api/index.php")
if ($rest.LastMethodSuccess -ne $true) {
    $($rest.LastErrorText)
    exit
}

# We should expect a 200 response if successful.
if ($rest.ResponseStatusCode -ne 200) {
    $("Request Header: ")
    $($rest.LastRequestHeader)
    $("----")
    $("Response StatusCode = " + $rest.ResponseStatusCode)
    $("Response StatusLine: " + $rest.ResponseStatusText)
    $("Response Header:")
    $($rest.ResponseHeader)
    $("Response Body:")
    $($responseBody)
    exit
}

$xml = New-Object Chilkat.Xml
$xml.LoadXml($responseBody)
$($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")