(C) Populi Search People

Demonstrates the Populi searchPeople task.

Chilkat C/C++ Library Downloads
MS Visual C/C++ Linux/CentOS C/C++ Alpine Linux C/C++ MAC OS X C/C++	armhf/aarch64 C/C++ C++ Builder iOS C/C++ Android C/C++	Solaris C/C++ MinGW C/C++

#include <C_CkXml.h>
#include <C_CkRest.h>

void ChilkatSample(void)
    {
    HCkXml xml;
    BOOL success;
    const char *accessKey;
    HCkRest rest;
    BOOL bAutoReconnect;
    const char *responseBody;
    int i;
    int count_i;
    int id;
    const char *first_name;
    const char *last_name;
    const char *middle_name;
    const char *preferred_name;
    int is_user;
    const char *primary_email;

    // 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 = CkXml_Create();
    success = CkXml_LoadXmlFile(xml,"qa_data/tokens/populi_token.xml");
    accessKey = CkXml_getChildContent(xml,"access_key");
    if (CkXml_getLastMethodSuccess(xml) != TRUE) {
        printf("Did not find the access_key\n");
        CkXml_Dispose(xml);
        return;
    }

    rest = CkRest_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 = CkRest_Connect(rest,"yourcollege.populi.co",443,TRUE,bAutoReconnect);
    if (success != TRUE) {
        printf("%s\n",CkRest_lastErrorText(rest));
        CkXml_Dispose(xml);
        CkRest_Dispose(rest);
        return;
    }

    CkRest_putAuthorization(rest,accessKey);

    CkRest_AddQueryParam(rest,"task","searchPeople");
    CkRest_AddQueryParam(rest,"search_term","Robert");
    CkRest_AddQueryParam(rest,"limit","10");

    responseBody = CkRest_fullRequestFormUrlEncoded(rest,"POST","/api/index.php");
    if (CkRest_getLastMethodSuccess(rest) != TRUE) {
        printf("%s\n",CkRest_lastErrorText(rest));
        CkXml_Dispose(xml);
        CkRest_Dispose(rest);
        return;
    }

    // We should expect a 200 response if successful.
    if (CkRest_getResponseStatusCode(rest) != 200) {
        printf("Request Header: \n");
        printf("%s\n",CkRest_lastRequestHeader(rest));
        printf("----\n");
        printf("Response StatusCode = %d\n",CkRest_getResponseStatusCode(rest));
        printf("Response StatusLine: %s\n",CkRest_responseStatusText(rest));
        printf("Response Header:\n");
        printf("%s\n",CkRest_responseHeader(rest));
        printf("Response Body:\n");
        printf("%s\n",responseBody);
        CkXml_Dispose(xml);
        CkRest_Dispose(rest);
        return;
    }

    CkXml_LoadXml(xml,responseBody);
    printf("%s\n",CkXml_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="UTF-8"?>
    //  <response>
    // 	<person>
    // 		<id>11111</id>
    // 		<first_name>Robert</first_name>
    // 		<last_name>McStudent</last_name>
    // 		<middle_name>Kensington</middle_name>
    // 		<preferred_name>Bobby</preferred_name>
    // 		<is_user>1</is_user>
    // 		<primary_email>r.mcstudent@myschool.edu</primary_email>
    // 	</person>
    // 	<person>
    // 		<id>2222</id>
    // 		<first_name>Robert</first_name>
    // 		<last_name>McBoardmember</last_name>
    // 		<middle_name/>
    // 		<preferred_name/>
    // 		<is_user>0</is_user>
    // 		<primary_email>robert@gmail.com</primary_email>
    // 	</person>
    // </response>

    i = 0;
    count_i = CkXml_NumChildrenHavingTag(xml,"person");
    while (i < count_i) {
        CkXml_putI(xml,i);
        id = CkXml_GetChildIntValue(xml,"person[i]|id");
        first_name = CkXml_getChildContent(xml,"person[i]|first_name");
        last_name = CkXml_getChildContent(xml,"person[i]|last_name");
        middle_name = CkXml_getChildContent(xml,"person[i]|middle_name");
        preferred_name = CkXml_getChildContent(xml,"person[i]|preferred_name");
        is_user = CkXml_GetChildIntValue(xml,"person[i]|is_user");
        primary_email = CkXml_getChildContent(xml,"person[i]|primary_email");
        i = i + 1;
    }



    CkXml_Dispose(xml);
    CkRest_Dispose(rest);

    }