(Delphi ActiveX) Yousign Procedure Creation Basic Mode Upload File

Demonstrates the 1st step of Yousign procedure creation, which is to upload a PDF file.

For more information, see https://dev.yousign.com/?version=latest#0889a9c5-aa1e-4de0-9b35-4d6621b4eb20

Chilkat for Delphi Downloads Chilkat ActiveX DLL for Delphi Chilkat non-ActiveX DLL for Delphi * The examples here use the ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Chilkat_TLB;

...

procedure TForm1.Button1Click(Sender: TObject);
var
http: TChilkatHttp;
success: Integer;
pdfData: TChilkatBinData;
json: TChilkatJsonObject;
resp: IChilkatHttpResponse;
sbResponseBody: TChilkatStringBuilder;
jResp: TChilkatJsonObject;
respStatusCode: Integer;
id: WideString;
name: WideString;
v_type: WideString;
contentType: WideString;
description: WideString;
createdAt: WideString;
updatedAt: WideString;
sha256: WideString;
workspace: WideString;
creator: WideString;
v_protected: Integer;
position: Integer;
parent: WideString;
i: Integer;
count_i: Integer;

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

http := TChilkatHttp.Create(Self);

// Implements the following CURL command:

// curl --location --request POST 'https://staging-api.yousign.com/files' \
// --header 'Authorization: Bearer YOUR_API_KEY' \
// --header 'Content-Type: application/json' \
// --data-raw '{
//     "name": "The best name for my file.pdf",
//     "content": "JVBERi0..." }'

// Load a PDF file to be uploaded.
pdfData := TChilkatBinData.Create(Self);
success := pdfData.LoadFile('qa_data/pdf/helloWorld.pdf');
if (success = 0) then
  begin
    Memo1.Lines.Add('Failed to load PDF local file.');
    Exit;
  end;

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

// Use this online tool to generate code from sample JSON:
// Generate Code to Create JSON

// The following JSON is sent in the request body.

// {
//   "name": "The best name for my file.pdf",
//   "content": "JVBERi0..."
// }

json := TChilkatJsonObject.Create(Self);
json.UpdateString('name','helloWorld.pdf');
json.UpdateString('content',pdfData.GetEncoded('base64'));

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

resp := http.PostJson3('https://staging-api.yousign.com/files','application/json',json.ControlInterface);
if (http.LastMethodSuccess = 0) then
  begin
    Memo1.Lines.Add(http.LastErrorText);
    Exit;
  end;

sbResponseBody := TChilkatStringBuilder.Create(Self);
resp.GetBodySb(sbResponseBody.ControlInterface);
jResp := TChilkatJsonObject.Create(Self);
jResp.LoadSb(sbResponseBody.ControlInterface);
jResp.EmitCompact := 0;

Memo1.Lines.Add('Response Body:');
Memo1.Lines.Add(jResp.Emit());

respStatusCode := resp.StatusCode;
Memo1.Lines.Add('Response Status Code = ' + IntToStr(respStatusCode));
if (respStatusCode >= 400) then
  begin
    Memo1.Lines.Add('Response Header:');
    Memo1.Lines.Add(resp.Header);
    Memo1.Lines.Add('Failed.');

    Exit;
  end;

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

// {
//   "id": "/files/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
//   "name": "The best name for my file.pdf",
//   "type": "signable",
//   "contentType": "application/pdf",
//   "description": null,
//   "createdAt": "2018-12-01T11:36:20+01:00",
//   "updatedAt": "2018-12-01T11:36:20+01:00",
//   "sha256": "bb57ae2b2ca6ad0133a699350d1a6f6c8cdfde3cf872cf526585d306e4675cc2",
//   "metadata": [
//   ],
//   "workspace": "/workspaces/XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
//   "creator": null,
//   "protected": false,
//   "position": 0,
//   "parent": null
// }

// 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');
name := jResp.StringOf('name');
v_type := jResp.StringOf('type');
contentType := jResp.StringOf('contentType');
description := jResp.StringOf('description');
createdAt := jResp.StringOf('createdAt');
updatedAt := jResp.StringOf('updatedAt');
sha256 := jResp.StringOf('sha256');
workspace := jResp.StringOf('workspace');
creator := jResp.StringOf('creator');
v_protected := jResp.BoolOf('protected');
position := jResp.IntOf('position');
parent := jResp.StringOf('parent');
i := 0;
count_i := jResp.SizeOfArray('metadata');
while i < count_i do
  begin
    jResp.I := i;
    i := i + 1;
  end;
end;