C++

Yousign: Making your first API call

See more Yousign Examples

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

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

void ChilkatSample(void)
    {
    bool success = false;

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

    CkHttp http;

    //  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) {
        std::cout << http.lastErrorText() << "\r\n";
        return;
    }

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

    std::cout << "Response Body:" << "\r\n";
    std::cout << jResp.emit() << "\r\n";

    int respStatusCode = http.get_LastStatus();
    std::cout << "Response Status Code = " << respStatusCode << "\r\n";
    if (respStatusCode >= 400) {
        std::cout << "Response Header:" << "\r\n";
        std::cout << http.lastHeader() << "\r\n";
        std::cout << "Failed." << "\r\n";
        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;
    }
    }