DBUserClient

@interface DBUserClient : DBUserBaseClient

Dropbox User API Client for all endpoints with auth type user.

This is the SDK user’s primary interface with the Dropbox API. Routes can be accessed via each namespace object in the instance fields of its parent, DBUserBaseClient. To see a full list of the User API endpoints available, please visit: https://www.dropbox.com/developers/documentation/http/documentation.

  • Identifies a unique Dropbox account. Used for the multi Dropbox account case where client objects are each associated with a particular Dropbox account.

    Declaration

    Objective-C

    @property (readonly, copy, nonatomic, nullable) NSString *tokenUid;

    Swift

    var tokenUid: String? { get }
  • Convenience constructor.

    Uses standard network configuration parameters.

    Declaration

    Objective-C

    - (nonnull instancetype)initWithAccessToken:(nonnull NSString *)accessToken;

    Swift

    init(accessToken: String)

    Parameters

    accessToken

    The Dropbox OAuth 2.0 access token used to make requests.

    Return Value

    An initialized instance.

  • Convenience constructor.

    Declaration

    Objective-C

    - (nonnull instancetype)
    initWithAccessToken:(nonnull NSString *)accessToken
        transportConfig:(nullable DBTransportDefaultConfig *)transportConfig;

    Swift

    init(accessToken: String, transport transportConfig: DBTransportDefaultConfig?)

    Parameters

    accessToken

    The Dropbox OAuth 2.0 access token used to make requests.

    transportConfig

    A wrapper around the different parameters that can be set to change network calling behavior. DBTransportDefaultConfig offers a number of different constructors to customize networking settings.

    Return Value

    An initialized instance.

  • Full constructor.

    Declaration

    Objective-C

    - (nonnull instancetype)
    initWithAccessToken:(nonnull NSString *)accessToken
               tokenUid:(nullable NSString *)tokenUid
        transportConfig:(nullable DBTransportDefaultConfig *)transportConfig;

    Swift

    init(accessToken: String, tokenUid: String?, transport transportConfig: DBTransportDefaultConfig?)

    Parameters

    accessToken

    The Dropbox OAuth 2.0 access token used to make requests.

    tokenUid

    Identifies a unique Dropbox account. Used for the multi Dropbox account case where client objects are each associated with a particular Dropbox account.

    transportConfig

    A wrapper around the different parameters that can be set to change network calling behavior. DBTransportDefaultConfig offers a number of different constructors to customize networking settings.

    Return Value

    An initialized instance.

  • Returns a DBUserClient instance that can be used to make API calls with given path root value.

    Declaration

    Objective-C

    - (nonnull DBUserClient *)withPathRoot:(nonnull DBCOMMONPathRoot *)pathRoot;

    Swift

    func withPathRoot(_ pathRoot: DBCOMMONPathRoot) -> DBUserClient

    Parameters

    pathRoot

    Value of the path root object which will be used as Dropbox-Api-Path-Root header.

    Return Value

    An initialized User API client instance.

  • Returns the current access token used to make API requests.

    Declaration

    Objective-C

    - (nullable NSString *)accessToken;

    Swift

    func accessToken() -> String?
  • Returns whether the client is authorized.

    Declaration

    Objective-C

    - (BOOL)isAuthorized;

    Swift

    func isAuthorized() -> Bool

    Return Value

    Whether the client currently has a non-nil OAuth 2.0 access token.