(MFC) Yousign: Making your first API call

Demonstrates making the simplest of calls to test your API key. This example tests using the sandbox URLs.

For more information, see https://dev.yousign.com/?version=latest#c803dbec-2afb-4b2d-b70b-b42e5c8cbc9a

Chilkat C/C++ Library Downloads MS Visual C/C++ Libs

See Also: Using MFC CString in Chilkat

#include <CkHttp.h>
#include <CkStringBuilder.h>
#include <CkJsonObject.h>

void ChilkatSample(void)
    {
    CkString strOut;

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

    CkHttp http;
    bool success;

    // Implements the following CURL command:

    // curl --location --request GET 'https://staging-api.yousign.com/users' \
    // --header 'Authorization: Bearer YOUR_API_KEY' \
    // --header 'Content-Type: application/json'

    // Use the following online tool to generate HTTP code from a CURL command
    // Convert a cURL Command to HTTP Source Code

    // Adds the "Authorization: Bearer YOUR_API_KEY" header.
    http.put_AuthToken("YOUR_API_KEY");
    http.SetRequestHeader("Content-Type","application/json");

    CkStringBuilder sbResponseBody;
    success = http.QuickGetSb("https://staging-api.yousign.com/users",sbResponseBody);
    if (success == false) {
        strOut.append(http.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    CkJsonObject jResp;
    jResp.LoadSb(sbResponseBody);
    jResp.put_EmitCompact(false);

    strOut.append("Response Body:");
    strOut.append("\r\n");
    strOut.append(jResp.emit());
    strOut.append("\r\n");

    int respStatusCode = http.get_LastStatus();
    strOut.append("Response Status Code = ");
    strOut.appendInt(respStatusCode);
    strOut.append("\r\n");
    if (respStatusCode >= 400) {
        strOut.append("Response Header:");
        strOut.append("\r\n");
        strOut.append(http.lastHeader());
        strOut.append("\r\n");
        strOut.append("Failed.");
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    // Sample JSON response:
    // (Sample code for parsing the JSON response is shown below)

    // {
    //   "id": "/users/XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    //   "firstname": "John",
    //   "lastname": "Doe",
    //   "email": "john.doe@yousign.fr",
    //   "title": "Developer",
    //   "phone": "+33612345678",
    //   "status": "activated",
    //   "organization": "/organizations/XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    //   "workspaces": [
    //     {
    //       "id": "/workspaces/XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    //       "name": "Acme"
    //     }
    //   ],
    //   "permission": "ROLE_ADMIN",
    //   "group": {
    //     "id": "/user_groups/XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    //     "name": "Administrateur",
    //     "permissions": [
    //       "procedure_write",
    //       "procedure_template_write",
    //       "procedure_create_from_template",
    //       "contact",
    //       "sign",
    //       "organization",
    //       "user",
    //       "api_key",
    //       "procedure_custom_field",
    //       "signature_ui",
    //       "certificate",
    //       "archive"
    //     ]
    //   },
    //   "createdAt": "2018-12-01T09:42:25+01:00",
    //   "updatedAt": "2018-12-01T09:42:25+01:00",
    //   "deleted": false,
    //   "deletedAt": null,
    //   "config": [
    //   ],
    //   "inweboUserRequest": null,
    //   "samlNameId": null,
    //   "defaultSignImage": null,
    //   "notifications": {
    //     "procedure": true
    //   },
    //   "fastSign": false,
    //   "fullName": "John Doe"
    // }

    // Sample code for parsing the JSON response...
    // Use the following online tool to generate parsing code from sample JSON:
    // Generate Parsing Code from JSON

    // Chilkat functions returning "const char *" return a pointer to temporary internal memory owned and managed by Chilkat.
    // See this example explaining how this memory should be used: const char * functions.

    const char *name = 0;
    const char *strVal = 0;

    const char *id = jResp.stringOf("id");
    const char *firstname = jResp.stringOf("firstname");
    const char *lastname = jResp.stringOf("lastname");
    const char *email = jResp.stringOf("email");
    const char *title = jResp.stringOf("title");
    const char *phone = jResp.stringOf("phone");
    const char *status = jResp.stringOf("status");
    const char *organization = jResp.stringOf("organization");
    const char *permission = jResp.stringOf("permission");
    const char *groupId = jResp.stringOf("group.id");
    const char *groupName = jResp.stringOf("group.name");
    const char *createdAt = jResp.stringOf("createdAt");
    const char *updatedAt = jResp.stringOf("updatedAt");
    bool deleted = jResp.BoolOf("deleted");
    const char *deletedAt = jResp.stringOf("deletedAt");
    const char *inweboUserRequest = jResp.stringOf("inweboUserRequest");
    const char *samlNameId = jResp.stringOf("samlNameId");
    const char *defaultSignImage = jResp.stringOf("defaultSignImage");
    bool notificationsProcedure = jResp.BoolOf("notifications.procedure");
    bool fastSign = jResp.BoolOf("fastSign");
    const char *fullName = jResp.stringOf("fullName");
    int i = 0;
    int count_i = jResp.SizeOfArray("workspaces");
    while (i < count_i) {
        jResp.put_I(i);
        id = jResp.stringOf("workspaces[i].id");
        name = jResp.stringOf("workspaces[i].name");
        i = i + 1;
    }

    i = 0;
    count_i = jResp.SizeOfArray("group.permissions");
    while (i < count_i) {
        jResp.put_I(i);
        strVal = jResp.stringOf("group.permissions[i]");
        i = i + 1;
    }

    i = 0;
    count_i = jResp.SizeOfArray("config");
    while (i < count_i) {
        jResp.put_I(i);
        i = i + 1;
    }



    SetDlgItemText(IDC_EDIT1,strOut.getUnicode());

    }