Pascal (Lazarus/Delphi)

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. Pascal (Lazarus/Delphi)

program ChilkatDemo;

// Demonstrates using the Chilkat Pascal wrapper via the C bridge DLL.
// Builds as a console application under Lazarus (FPC) or Delphi.

{$IFDEF FPC}
  {$MODE DELPHI}
{$ENDIF}
{$APPTYPE CONSOLE}

uses
  {$IFDEF UNIX}
  cthreads,
  {$ENDIF}
  SysUtils,
  CkDllLoader,
  Chilkat.Http,
  Chilkat.StringBuilder,
  Chilkat.JsonObject;

// ---------------------------------------------------------------------------

procedure RunDemo;
var
  success: Boolean;
  http: THttp;
  sbResponseBody: TStringBuilder;
  jResp: TJsonObject;
  respStatusCode: Integer;
  name: string;
  strVal: string;
  id: string;
  firstname: string;
  lastname: string;
  email: string;
  title: string;
  phone: string;
  status: string;
  organization: string;
  permission: string;
  groupId: string;
  groupName: string;
  createdAt: string;
  updatedAt: string;
  deleted: Boolean;
  deletedAt: string;
  inweboUserRequest: string;
  samlNameId: string;
  defaultSignImage: string;
  notificationsProcedure: Boolean;
  fastSign: Boolean;
  fullName: string;
  i: Integer;
  count_i: Integer;

begin
  success := False;

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

  http := THttp.Create;

  //  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.AuthToken := 'YOUR_API_KEY';
  http.SetRequestHeader('Content-Type','application/json');

  sbResponseBody := TStringBuilder.Create;
  success := http.QuickGetSb('https://staging-api.yousign.com/users',sbResponseBody);
  if (success = False) then
    begin
      WriteLn(http.LastErrorText);
      Exit;
    end;

  jResp := TJsonObject.Create;
  jResp.LoadSb(sbResponseBody);
  jResp.EmitCompact := False;

  WriteLn('Response Body:');
  WriteLn(jResp.Emit());

  respStatusCode := http.LastStatus;
  WriteLn('Response Status Code = ' + respStatusCode);
  if (respStatusCode >= 400) then
    begin
      WriteLn('Response Header:');
      WriteLn(http.LastHeader);
      WriteLn('Failed.');
      Exit;
    end;

  //  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

  id := jResp.StringOf('id');
  firstname := jResp.StringOf('firstname');
  lastname := jResp.StringOf('lastname');
  email := jResp.StringOf('email');
  title := jResp.StringOf('title');
  phone := jResp.StringOf('phone');
  status := jResp.StringOf('status');
  organization := jResp.StringOf('organization');
  permission := jResp.StringOf('permission');
  groupId := jResp.StringOf('group.id');
  groupName := jResp.StringOf('group.name');
  createdAt := jResp.StringOf('createdAt');
  updatedAt := jResp.StringOf('updatedAt');
  deleted := jResp.BoolOf('deleted');
  deletedAt := jResp.StringOf('deletedAt');
  inweboUserRequest := jResp.StringOf('inweboUserRequest');
  samlNameId := jResp.StringOf('samlNameId');
  defaultSignImage := jResp.StringOf('defaultSignImage');
  notificationsProcedure := jResp.BoolOf('notifications.procedure');
  fastSign := jResp.BoolOf('fastSign');
  fullName := jResp.StringOf('fullName');
  i := 0;
  count_i := jResp.SizeOfArray('workspaces');
  while i < count_i do
    begin
      jResp.I := i;
      id := jResp.StringOf('workspaces[i].id');
      name := jResp.StringOf('workspaces[i].name');
      i := i + 1;
    end;

  i := 0;
  count_i := jResp.SizeOfArray('group.permissions');
  while i < count_i do
    begin
      jResp.I := i;
      strVal := jResp.StringOf('group.permissions[i]');
      i := i + 1;
    end;

  i := 0;
  count_i := jResp.SizeOfArray('config');
  while i < count_i do
    begin
      jResp.I := i;
      i := i + 1;
    end;



  http.Free;
  sbResponseBody.Free;
  jResp.Free;

end;

// ---------------------------------------------------------------------------

begin

  try
    RunDemo;
  except
    on E: Exception do
      WriteLn('Unhandled exception: ', E.ClassName, ': ', E.Message);
  end;

  WriteLn;
  {$IFDEF MSWINDOWS}
  WriteLn('Press Enter to exit...');
  ReadLn;
  {$ENDIF}
end.