B4X

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.

B4X

Dim success As Boolean = False

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

Dim rest As ChilkatRest
rest.Initialize("rest")

'  Connect to the www.dropbox.com endpoint.
Dim bTls As Boolean = True
Dim port As Int = 443
Dim bAutoReconnect As Boolean = True
success = rest.Connect("api.dropboxapi.com", port, bTls, bAutoReconnect)
If success = False Then
    Log(rest.LastErrorText)
    Return
End If


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

Dim json As ChilkatJsonObject
json.Initialize
'  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)

Dim responseStr As String = rest.FullRequestString("POST", "/2/files/list_folder", json.Emit)
If rest.LastMethodSuccess = False Then
    Log(rest.LastErrorText)
    Return
End If


'  Success is indicated by a 200 response status code.
If rest.ResponseStatusCode <> 200 Then
    '  Examine the request/response to see what happened.
    Log("response status code = " & rest.ResponseStatusCode)
    Log("response status text = " & rest.ResponseStatusText)
    Log("response header: " & rest.ResponseHeader)
    Log("response body (if any): " & responseStr)
    Log("---")
    Log("LastRequestStartLine: " & rest.LastRequestStartLine)
    Log("LastRequestHeader: " & rest.LastRequestHeader)
    Return
End If


Dim jsonResponse As ChilkatJsonObject
jsonResponse.Initialize
jsonResponse.Load(responseStr)

jsonResponse.EmitCompact = False
Log(jsonResponse.Emit)

'  A sample JSON response is shown at the end of this example.
'  The following code iterates over the entries.
Dim dt As ChilkatDtObj
dt.Initialize
Dim numEntries As Int = jsonResponse.SizeOfArray("entries")
Dim i As Int = 0
Do While i < numEntries
    jsonResponse.I = i
    Log("----")
    Log("name: " & jsonResponse.StringOf("entries[i].name"))
    Log("path_lower: " & jsonResponse.StringOf("entries[i].path_lower"))
    Log("path_display: " & jsonResponse.StringOf("entries[i].path_display"))
    If jsonResponse.HasMember("entries[i].sharing_info") = True Then
        Log("has sharing_info...")
        Log("read_only: " & jsonResponse.StringOf("entries[i].sharing_info.read_only"))
        Log("shared_folder_id: " & jsonResponse.StringOf("entries[i].sharing_info.shared_folder_id"))
    End If

    If jsonResponse.HasMember("entries[i].client_modified") = True Then
        '  Demonstrate how to parse a date/time:
        Dim ckdt As ChilkatDateTime
        ckdt.Initialize
        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.
        Dim bLocalDateTime As Boolean = True
        ckdt.ToDtObj(bLocalDateTime, dt)

        Log(dt.Year & "-" & dt.Month & "-" & dt.Day)
    End If

    i = i + 1
Loop

Log("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
'  }
'