(Tcl) 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 Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

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

set rest [new_CkRest]

# Connect to the www.dropbox.com endpoint.
set bTls 1
set port 443
set bAutoReconnect 1
set success [CkRest_Connect $rest "api.dropboxapi.com" $port $bTls $bAutoReconnect]
if {$success != 1} then {
    puts [CkRest_lastErrorText $rest]
    delete_CkRest $rest
    exit
}

CkRest_AddHeader $rest "Content-Type" "application/json"
CkRest_AddHeader $rest "Authorization" "Bearer DROPBOX-ACCESS-TOKEN"

set json [new_CkJsonObject]

# The root folder should be an empty string, not "/"
CkJsonObject_AppendString $json "path" ""
CkJsonObject_AppendBool $json "recursive" 0
CkJsonObject_AppendBool $json "include_media_info" 0
CkJsonObject_AppendBool $json "include_deleted" 0
CkJsonObject_AppendBool $json "include_has_explicit_shared_members" 0

set responseStr [CkRest_fullRequestString $rest "POST" "/2/files/list_folder" [CkJsonObject_emit $json]]
if {[CkRest_get_LastMethodSuccess $rest] != 1} then {
    puts [CkRest_lastErrorText $rest]
    delete_CkRest $rest
    delete_CkJsonObject $json
    exit
}

# Success is indicated by a 200 response status code.
if {[CkRest_get_ResponseStatusCode $rest] != 200} then {
    # Examine the request/response to see what happened.
    puts "response status code = [CkRest_get_ResponseStatusCode $rest]"
    puts "response status text = [CkRest_responseStatusText $rest]"
    puts "response header: [CkRest_responseHeader $rest]"
    puts "response body (if any): $responseStr"
    puts "---"
    puts "LastRequestStartLine: [CkRest_lastRequestStartLine $rest]"
    puts "LastRequestHeader: [CkRest_lastRequestHeader $rest]"
    delete_CkRest $rest
    delete_CkJsonObject $json
    exit
}

set jsonResponse [new_CkJsonObject]

CkJsonObject_Load $jsonResponse $responseStr

CkJsonObject_put_EmitCompact $jsonResponse 0
puts [CkJsonObject_emit $jsonResponse]

# A sample JSON response is shown at the end of this example.
# The following code iterates over the entries.
set numEntries [CkJsonObject_SizeOfArray $jsonResponse "entries"]
set i 0
while {$i < $numEntries} {
    CkJsonObject_put_I $jsonResponse $i
    puts "----"
    puts "name: [CkJsonObject_stringOf $jsonResponse {entries[i].name}]"
    puts "path_lower: [CkJsonObject_stringOf $jsonResponse {entries[i].path_lower}]"
    puts "path_display: [CkJsonObject_stringOf $jsonResponse {entries[i].path_display}]"
    if {[CkJsonObject_HasMember $jsonResponse "entries[i].sharing_info"] == 1} then {
        puts "has sharing_info..."
        puts "read_only: [CkJsonObject_stringOf $jsonResponse {entries[i].sharing_info.read_only}]"
        puts "shared_folder_id: [CkJsonObject_stringOf $jsonResponse {entries[i].sharing_info.shared_folder_id}]"
    }

    if {[CkJsonObject_HasMember $jsonResponse "entries[i].client_modified"] == 1} then {
        # Demonstrate how to parse a date/time:
        set ckdt [new_CkDateTime]

        set success [CkDateTime_SetFromTimestamp $ckdt [CkJsonObject_stringOf $jsonResponse "entries[i].client_modified"]]
        # The date/time can now be converted to many other formats, or the individual parts
        # can be accessed.
        set bLocalDateTime 1
        # dt is a CkDtObj
        set dt [CkDateTime_GetDtObj $ckdt $bLocalDateTime]
        puts [CkDtObj_get_Year $dt]-[CkDtObj_get_Month $dt]-[CkDtObj_get_Day $dt]
        delete_CkDtObj $dt

    }

    set i [expr $i + 1]
}

puts "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
# }
# 

delete_CkRest $rest
delete_CkJsonObject $json
delete_CkJsonObject $jsonResponse
delete_CkDateTime $ckdt