Delphi DLL Dropbox: Dropbox Delete a File

Back to Index

Deletes a file on Dropbox

Documentation: https://www.dropbox.com/developers/documentation/http/documentation#files-delete

CURL Command

curl -X POST https://api.dropboxapi.com/2/files/delete_v2 \
    --header "Authorization: Bearer DROPBOX-ACCESS-TOKEN" \
    --header "Content-Type: application/json" \
    --data "{\"path\": \"/Homework/math/Prime_Numbers.txt\"}"

Delphi DLL Example

var
rest: HCkRest;
success: Boolean;
bTls: Boolean;
port: Integer;
bAutoReconnect: Boolean;
json: HCkJsonObject;
sbRequestBody: HCkStringBuilder;
sbResponseBody: HCkStringBuilder;
respStatusCode: Integer;
jsonResponse: HCkJsonObject;
i: Integer;
count_i: Integer;
j: Integer;
count_j: Integer;
metadataTag: PWideChar;
metadataName: PWideChar;
metadataId: PWideChar;
metadataClient_modified: PWideChar;
metadataServer_modified: PWideChar;
metadataRev: PWideChar;
metadataSize: Integer;
metadataPath_lower: PWideChar;
metadataPath_display: PWideChar;
metadataSharing_infoRead_only: Boolean;
metadataSharing_infoParent_shared_folder_id: PWideChar;
metadataSharing_infoModified_by: PWideChar;
metadataHas_explicit_shared_members: Boolean;
metadataContent_hash: PWideChar;
template_id: PWideChar;
name: PWideChar;
value: PWideChar;

begin
rest := CkRest_Create();

//  URL: https://api.dropboxapi.com/2/files/delete_v2
bTls := True;
port := 443;
bAutoReconnect := True;
success := CkRest_Connect(rest,'api.dropboxapi.com',port,bTls,bAutoReconnect);
if (success <> True) then
  begin
    Memo1.Lines.Add('ConnectFailReason: ' + IntToStr(CkRest_getConnectFailReason(rest)));
    Memo1.Lines.Add(CkRest__lastErrorText(rest));
    Exit;
  end;

//  See the Online Tool for Generating JSON Creation Code
json := CkJsonObject_Create();
CkJsonObject_UpdateString(json,'path','/Homework/math/Prime_Numbers.txt');

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

sbRequestBody := CkStringBuilder_Create();
CkJsonObject_EmitSb(json,sbRequestBody);
sbResponseBody := CkStringBuilder_Create();
success := CkRest_FullRequestSb(rest,'POST','/2/files/delete_v2',sbRequestBody,sbResponseBody);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkRest__lastErrorText(rest));
    Exit;
  end;
respStatusCode := CkRest_getResponseStatusCode(rest);
if (respStatusCode >= 400) then
  begin
    Memo1.Lines.Add('Response Status Code = ' + IntToStr(respStatusCode));
    Memo1.Lines.Add('Response Header:');
    Memo1.Lines.Add(CkRest__responseHeader(rest));
    Memo1.Lines.Add('Response Body:');
    Memo1.Lines.Add(CkStringBuilder__getAsString(sbResponseBody));
    Exit;
  end;

jsonResponse := CkJsonObject_Create();
CkJsonObject_LoadSb(jsonResponse,sbResponseBody);

//  See the Online Tool for Generating JSON Parse Code

metadataTag := CkJsonObject__stringOf(jsonResponse,'metadata.".tag"');
metadataName := CkJsonObject__stringOf(jsonResponse,'metadata.name');
metadataId := CkJsonObject__stringOf(jsonResponse,'metadata.id');
metadataClient_modified := CkJsonObject__stringOf(jsonResponse,'metadata.client_modified');
metadataServer_modified := CkJsonObject__stringOf(jsonResponse,'metadata.server_modified');
metadataRev := CkJsonObject__stringOf(jsonResponse,'metadata.rev');
metadataSize := CkJsonObject_IntOf(jsonResponse,'metadata.size');
metadataPath_lower := CkJsonObject__stringOf(jsonResponse,'metadata.path_lower');
metadataPath_display := CkJsonObject__stringOf(jsonResponse,'metadata.path_display');
metadataSharing_infoRead_only := CkJsonObject_BoolOf(jsonResponse,'metadata.sharing_info.read_only');
metadataSharing_infoParent_shared_folder_id := CkJsonObject__stringOf(jsonResponse,'metadata.sharing_info.parent_shared_folder_id');
metadataSharing_infoModified_by := CkJsonObject__stringOf(jsonResponse,'metadata.sharing_info.modified_by');
metadataHas_explicit_shared_members := CkJsonObject_BoolOf(jsonResponse,'metadata.has_explicit_shared_members');
metadataContent_hash := CkJsonObject__stringOf(jsonResponse,'metadata.content_hash');
i := 0;
count_i := CkJsonObject_SizeOfArray(jsonResponse,'metadata.property_groups');
while i < count_i do
  begin
CkJsonObject_putI(jsonResponse,i);
    template_id := CkJsonObject__stringOf(jsonResponse,'metadata.property_groups[i].template_id');
    j := 0;
    count_j := CkJsonObject_SizeOfArray(jsonResponse,'metadata.property_groups[i].fields');
    while j < count_j do
      begin
CkJsonObject_putJ(jsonResponse,j);
        name := CkJsonObject__stringOf(jsonResponse,'metadata.property_groups[i].fields[j].name');
        value := CkJsonObject__stringOf(jsonResponse,'metadata.property_groups[i].fields[j].value');
        j := j + 1;
      end;

    i := i + 1;
  end;

CkRest_Dispose(rest);
CkJsonObject_Dispose(json);
CkStringBuilder_Dispose(sbRequestBody);
CkStringBuilder_Dispose(sbResponseBody);
CkJsonObject_Dispose(jsonResponse);

Sample JSON Response Body

{
  "metadata": {
    ".tag": "file",
    "name": "Prime_Numbers.txt",
    "id": "id:a4ayc_80_OEAAAAAAAAAXw",
    "client_modified": "2015-05-12T15:50:38Z",
    "server_modified": "2015-05-12T15:50:38Z",
    "rev": "a1c10ce0dd78",
    "size": 7212,
    "path_lower": "/homework/math/prime_numbers.txt",
    "path_display": "/Homework/math/Prime_Numbers.txt",
    "sharing_info": {
      "read_only": true,
      "parent_shared_folder_id": "84528192421",
      "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
    },
    "property_groups": [
      {
        "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
        "fields": [
          {
            "name": "Security Policy",
            "value": "Confidential"
          }
        ]
      }
    ],
    "has_explicit_shared_members": false,
    "content_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
  }
}