(Objective-C) Dropbox: Access Your Own Account

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.

Chilkat Objective-C Library Downloads MAC OS X (Cocoa) Libs iOS Libs

#import <CkoRest.h>
#import <CkoJsonObject.h>
#import <NSString.h>
#import <CkoDateTime.h>
#import <CkoDtObj.h>

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

CkoRest *rest = [[CkoRest alloc] init];

// Connect to the www.dropbox.com endpoint.
BOOL bTls = YES;
int port = 443;
BOOL bAutoReconnect = YES;
BOOL success = [rest Connect: @"api.dropboxapi.com" port: [NSNumber numberWithInt: port] tls: bTls autoReconnect: bAutoReconnect];
if (success != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

[rest AddHeader: @"Content-Type" value: @"application/json"];
[rest AddHeader: @"Authorization" value: @"Bearer DROPBOX-ACCESS-TOKEN"];

CkoJsonObject *json = [[CkoJsonObject alloc] init];
// The root folder should be an empty string, not "/"
[json AppendString: @"path" value: @""];
[json AppendBool: @"recursive" value: NO];
[json AppendBool: @"include_media_info" value: NO];
[json AppendBool: @"include_deleted" value: NO];
[json AppendBool: @"include_has_explicit_shared_members" value: NO];

NSString *responseStr = [rest FullRequestString: @"POST" uriPath: @"/2/files/list_folder" bodyText: [json Emit]];
if (rest.LastMethodSuccess != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

// Success is indicated by a 200 response status code.
if ([rest.ResponseStatusCode intValue] != 200) {
    // Examine the request/response to see what happened.
    NSLog(@"%@%d",@"response status code = ",[rest.ResponseStatusCode intValue]);
    NSLog(@"%@%@",@"response status text = ",rest.ResponseStatusText);
    NSLog(@"%@%@",@"response header: ",rest.ResponseHeader);
    NSLog(@"%@%@",@"response body (if any): ",responseStr);
    NSLog(@"%@",@"---");
    NSLog(@"%@%@",@"LastRequestStartLine: ",rest.LastRequestStartLine);
    NSLog(@"%@%@",@"LastRequestHeader: ",rest.LastRequestHeader);
    return;
}

CkoJsonObject *jsonResponse = [[CkoJsonObject alloc] init];
[jsonResponse Load: responseStr];

jsonResponse.EmitCompact = NO;
NSLog(@"%@",[jsonResponse Emit]);

// A sample JSON response is shown at the end of this example.
// The following code iterates over the entries.
int numEntries = [[jsonResponse SizeOfArray: @"entries"] intValue];
int i = 0;
while (i < numEntries) {
    jsonResponse.I = [NSNumber numberWithInt: i];
    NSLog(@"%@",@"----");
    NSLog(@"%@%@",@"name: ",[jsonResponse StringOf: @"entries[i].name"]);
    NSLog(@"%@%@",@"path_lower: ",[jsonResponse StringOf: @"entries[i].path_lower"]);
    NSLog(@"%@%@",@"path_display: ",[jsonResponse StringOf: @"entries[i].path_display"]);
    if ([jsonResponse HasMember: @"entries[i].sharing_info"] == YES) {
        NSLog(@"%@",@"has sharing_info...");
        NSLog(@"%@%@",@"read_only: ",[jsonResponse StringOf: @"entries[i].sharing_info.read_only"]);
        NSLog(@"%@%@",@"shared_folder_id: ",[jsonResponse StringOf: @"entries[i].sharing_info.shared_folder_id"]);
    }

    if ([jsonResponse HasMember: @"entries[i].client_modified"] == YES) {
        // Demonstrate how to parse a date/time:
        CkoDateTime *ckdt = [[CkoDateTime alloc] init];
        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.
        BOOL bLocalDateTime = YES;
        CkoDtObj *dt = [ckdt GetDtObj: bLocalDateTime];
        NSLog(@"%d%@%d%@%d",[dt.Year intValue],@"-",[dt.Month intValue],@"-",[dt.Day intValue]);

    }

    i = i + 1;
}

NSLog(@"%@",@"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
// }
//