Sample code for 30+ languages & platforms
Unicode C

Populi Get Roles

See more Populi Examples

Demonstrates the Populi getRoles task.

Chilkat Unicode C Downloads

Unicode C
#include <C_CkXmlW.h>
#include <C_CkRestW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkXmlW xml;
    const wchar_t *accessKey;
    HCkRestW rest;
    BOOL bAutoReconnect;
    const wchar_t *responseBody;
    int i;
    int count_i;
    int id;
    const wchar_t *name;
    int inactive;

    success = FALSE;

    // 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 = CkXmlW_Create();
    success = CkXmlW_LoadXmlFile(xml,L"qa_data/tokens/populi_token.xml");
    accessKey = CkXmlW_getChildContent(xml,L"access_key");
    if (CkXmlW_getLastMethodSuccess(xml) != TRUE) {
        wprintf(L"Did not find the access_key\n");
        CkXmlW_Dispose(xml);
        return;
    }

    rest = CkRestW_Create();

    // 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 = CkRestW_Connect(rest,L"yourcollege.populi.co",443,TRUE,bAutoReconnect);
    if (success != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkXmlW_Dispose(xml);
        CkRestW_Dispose(rest);
        return;
    }

    CkRestW_putAuthorization(rest,accessKey);

    CkRestW_AddQueryParam(rest,L"task",L"getRoles");

    responseBody = CkRestW_fullRequestFormUrlEncoded(rest,L"POST",L"/api/index.php");
    if (CkRestW_getLastMethodSuccess(rest) != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkXmlW_Dispose(xml);
        CkRestW_Dispose(rest);
        return;
    }

    // We should expect a 200 response if successful.
    if (CkRestW_getResponseStatusCode(rest) != 200) {
        wprintf(L"Request Header: \n");
        wprintf(L"%s\n",CkRestW_lastRequestHeader(rest));
        wprintf(L"----\n");
        wprintf(L"Response StatusCode = %d\n",CkRestW_getResponseStatusCode(rest));
        wprintf(L"Response StatusLine: %s\n",CkRestW_responseStatusText(rest));
        wprintf(L"Response Header:\n");
        wprintf(L"%s\n",CkRestW_responseHeader(rest));
        wprintf(L"Response Body:\n");
        wprintf(L"%s\n",responseBody);
        CkXmlW_Dispose(xml);
        CkRestW_Dispose(rest);
        return;
    }

    CkXmlW_LoadXml(xml,responseBody);
    wprintf(L"%s\n",CkXmlW_getXml(xml));

    // 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 = CkXmlW_NumChildrenHavingTag(xml,L"role");
    while (i < count_i) {
        CkXmlW_putI(xml,i);
        id = CkXmlW_GetChildIntValue(xml,L"role[i]|id");
        name = CkXmlW_getChildContent(xml,L"role[i]|name");
        inactive = CkXmlW_GetChildIntValue(xml,L"role[i]|inactive");
        i = i + 1;
    }



    CkXmlW_Dispose(xml);
    CkRestW_Dispose(rest);

    }