An UNOFFICIAL Go SDK for integrating with the Dropbox API v2. Tested with Go 1.5+
Warning
|
This SDK is NOT yet official. What does this mean? |
-
There is no formal Dropbox support for this SDK at this point
-
Bugs may or may not get fixed
-
Not all SDK features may be implemented and implemented features may be buggy or incorrect
-
the SDK, while unofficial, is usable. See dbxcli for an example application built using the SDK
-
we would like to get feedback from the community and evaluate the level of interest/enthusiasm before investing into official supporting one more SDK
$ go get github.com/dropbox/dropbox-sdk-go-unofficial
Note that while the import path ends in dropbox-sdk-go-unofficial
, it actually exports the package dropbox
. There are additional subpackages, one for each namespace in the API:
-
github.com/dropbox/dropbox-sdk-go-unofficial/users
-
github.com/dropbox/dropbox-sdk-go-unofficial/files
-
github.com/dropbox/dropbox-sdk-go-unofficial/sharing
-
github.com/dropbox/dropbox-sdk-go-unofficial/team
First, you need to register a new "app" to start making API requests. Once you have created an app, you can either use the SDK via an access token (useful for testing) or via the regular OAuth2 flow (recommended for production).
Once you’ve created an app, you can get an access token from the app’s console. Note that this token will only work for the Dropbox account the token is associated with.
// NOTE: this imports package `dropbox`
import "github.com/dropbox/dropbox-sdk-go-unofficial"
func main() {
api := dropbox.Client(token, dropbox.Options{Verbose: true}) // second argument enables verbose logging in the SDK
// start making API calls
}
For this, you will need your APP_KEY
and APP_SECRET
from the developers console. Your app will then have to take users though the oauth flow, as part of which users will explicitly grant permissions to your app. At the end of this process, users will get a token that the app can then use for subsequent authentication. See this for an example of oauth2 flow in Go.
Once you have the token, usage is same as above.
Each Dropbox API takes in a request type and returns a response type. For instance, /users/get_account takes as input a GetAccountArg
and returns a BasicAccount
. The typical pattern for making API calls is:
-
Instantiate the argument via the
New*
convenience functions in the SDK -
Invoke the API
-
Process the response (or handle error, as below)
Here’s an example:
arg := users.NewGetAccountArg()
if resp, err := api.GetAccount(arg); err != nil {
return err
}
fmt.Printf("Name: %v", resp.Name)
As described in the API docs, all HTTP errors except 409 are returned as-is to the client (with a helpful text message where possible). In case of a 409, the SDK will return an endpoint-specific error as described in the API. This will be made available as EndpointError
member in the error.
All features of the Team API are supported except acting on behalf of team members. This should be available soon.
Note that to use the Team API, you will need to create a Dropbox Business App. The OAuth token from this app will only work for the Team API.
Please read the API docs carefully to appropriate secure your apps and tokens when using the Team API.