Pascal (Lazarus/Delphi)

Dropbox: Access Your Own Account

See more Dropbox Examples

To programmatically interact with your own Dropbox account, such as for uploading, downloading, listing files, etc., go to the Dropbox app console and create an application. Then generate an access token in the online app console as shown in the screenshot below. The access token does not expire, and can be used to access your own account from your own non-web application.

The example code, located below the screenshot, shows how to list the files in the root folder.

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.Rest,
  Chilkat.DtObj,
  Chilkat.JsonObject,
  Chilkat.CkDateTime;

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

procedure RunDemo;
var
  success: Boolean;
  rest: TRest;
  bTls: Boolean;
  port: Integer;
  bAutoReconnect: Boolean;
  json: TJsonObject;
  responseStr: string;
  jsonResponse: TJsonObject;
  dt: TDtObj;
  numEntries: Integer;
  i: Integer;
  ckdt: TCkDateTime;
  bLocalDateTime: Boolean;

begin
  success := False;

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

  rest := TRest.Create;

  //  Connect to the www.dropbox.com endpoint.
  bTls := True;
  port := 443;
  bAutoReconnect := True;
  success := rest.Connect('api.dropboxapi.com',port,bTls,bAutoReconnect);
  if (success = False) then
    begin
      WriteLn(rest.LastErrorText);
      Exit;
    end;

  rest.AddHeader('Content-Type','application/json');
  rest.AddHeader('Authorization','Bearer DROPBOX-ACCESS-TOKEN');

  json := TJsonObject.Create;
  //  The root folder should be an empty string, not "/"
  json.AppendString('path','');
  json.AppendBool('recursive',False);
  json.AppendBool('include_media_info',False);
  json.AppendBool('include_deleted',False);
  json.AppendBool('include_has_explicit_shared_members',False);

  responseStr := rest.FullRequestString('POST','/2/files/list_folder',json.Emit());
  if (rest.LastMethodSuccess = False) then
    begin
      WriteLn(rest.LastErrorText);
      Exit;
    end;

  //  Success is indicated by a 200 response status code.
  if (rest.ResponseStatusCode <> 200) then
    begin
      //  Examine the request/response to see what happened.
      WriteLn('response status code = ' + rest.ResponseStatusCode);
      WriteLn('response status text = ' + rest.ResponseStatusText);
      WriteLn('response header: ' + rest.ResponseHeader);
      WriteLn('response body (if any): ' + responseStr);
      WriteLn('---');
      WriteLn('LastRequestStartLine: ' + rest.LastRequestStartLine);
      WriteLn('LastRequestHeader: ' + rest.LastRequestHeader);
      Exit;
    end;

  jsonResponse := TJsonObject.Create;
  jsonResponse.Load(responseStr);

  jsonResponse.EmitCompact := False;
  WriteLn(jsonResponse.Emit());

  //  A sample JSON response is shown at the end of this example.
  //  The following code iterates over the entries.
  dt := TDtObj.Create;
  numEntries := jsonResponse.SizeOfArray('entries');
  i := 0;
  while i < numEntries do
    begin
      jsonResponse.I := i;
      WriteLn('----');
      WriteLn('name: ' + jsonResponse.StringOf('entries[i].name'));
      WriteLn('path_lower: ' + jsonResponse.StringOf('entries[i].path_lower'));
      WriteLn('path_display: ' + jsonResponse.StringOf('entries[i].path_display'));
      if (jsonResponse.HasMember('entries[i].sharing_info') = True) then
        begin
          WriteLn('has sharing_info...');
          WriteLn('read_only: ' + jsonResponse.StringOf('entries[i].sharing_info.read_only'));
          WriteLn('shared_folder_id: ' + jsonResponse.StringOf('entries[i].sharing_info.shared_folder_id'));
        end;
      if (jsonResponse.HasMember('entries[i].client_modified') = True) then
        begin
          //  Demonstrate how to parse a date/time:
          ckdt := TCkDateTime.Create;
          success := ckdt.SetFromTimestamp(jsonResponse.StringOf('entries[i].client_modified'));
          //  The date/time can now be converted to many other formats, or the individual parts
          //  can be accessed.
          bLocalDateTime := True;
          ckdt.ToDtObj(bLocalDateTime,dt);

          WriteLn(dt.Year + '-' + dt.Month + '-' + dt.Day);
        end;
      i := i + 1;
    end;

  WriteLn('Success.');

  //  {
  //    "entries": [
  //      {
  //        ".tag": "folder",
  //        "name": "chilkat Team Folder",
  //        "path_lower": "/chilkat team folder",
  //        "path_display": "/chilkat Team Folder",
  //        "id": "id:2VqX9RLr-JAAAAAAAAAAAQ",
  //        "shared_folder_id": "1210954290",
  //        "sharing_info": {
  //          "read_only": false,
  //          "shared_folder_id": "1210954290"
  //        }
  //      },
  //      {
  //        ".tag": "file",
  //        "name": "Get Started with Dropbox.pdf",
  //        "path_lower": "/get started with dropbox.pdf",
  //        "path_display": "/Get Started with Dropbox.pdf",
  //        "id": "id:oxE2oMDqH4AAAAAAAAAAAQ",
  //        "client_modified": "2016-05-07T11:47:47Z",
  //        "server_modified": "2016-05-07T11:47:47Z",
  //        "rev": "1483db13f",
  //        "size": 692088
  //      }
  //    ],
  //    "cursor": "AAEnZXciJyS4gzC_tlX6K2na4c8o7_09-dxmXKHpkPPyf3Kl0H4N-VYnz424nCrFOJuhMiM5_RgNAersumx9qe7NgCSdlppr80iFk0gf6vPlecM6SBtLcs6OYXL8ILWiZ62pfnOvgC3WKGlG6dqZ-VXH",
  //    "has_more": false
  //  }
  //  


  rest.Free;
  json.Free;
  jsonResponse.Free;
  dt.Free;
          ckdt.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.