FBSDKAccessToken
A more recent version of this class is available. Check out the latest version.

Represents an immutable access token for using Facebook services.

Conforms to:FBSDKCopying, NSSecureCoding
Inherits from:NSObject
Declared in:FBSDKAccessToken.h
Properties
appID

Returns the app ID.

@property (readonly, copy, nonatomic) NSString *appID;
Declared In: FBSDKAccessToken.h
declinedPermissions

Returns the known declined permissions.

@property (readonly, copy, nonatomic) NSSet *declinedPermissions;
Declared In: FBSDKAccessToken.h
expirationDate

Returns the expiration date.

@property (readonly, copy, nonatomic) NSDate *expirationDate;
Declared In: FBSDKAccessToken.h
permissions

Returns the known granted permissions.

@property (readonly, copy, nonatomic) NSSet *permissions;
Declared In: FBSDKAccessToken.h
refreshDate

Returns the date the token was last refreshed.

@property (readonly, copy, nonatomic) NSDate *refreshDate;
Declared In: FBSDKAccessToken.h
tokenString

Returns the opaque token string.

@property (readonly, copy, nonatomic) NSString *tokenString;
Declared In: FBSDKAccessToken.h
userID

Returns the user ID.

@property (readonly, copy, nonatomic) NSString *userID;
Declared In: FBSDKAccessToken.h
Class Methods
currentAccessToken

Returns the "global" access token that represents the currently logged in user.

+ (FBSDKAccessToken *) currentAccessToken;
Discussion:

The currentAccessToken is a convenient representation of the token of the current user and is used by other SDK components (like FBSDKLoginManager).

Declared In: FBSDKAccessToken.h
setCurrentAccessToken:

Sets the "global" access token that represents the currently logged in user.

ParameterDescription
token

The access token to set.

+ (void) setCurrentAccessToken:(FBSDKAccessToken *)token;
Discussion:

This will broadcast a notification and save the token to the app keychain.

Declared In: FBSDKAccessToken.h
Instance Methods
hasGranted:

Convenience getter to determine if a permission has been granted

ParameterDescription
permission

The permission to check.

- (BOOL) hasGranted:(NSString *)permission;
Declared In: FBSDKAccessToken.h
initWithTokenString:permissions:declinedPermissions:appID:userID:expirationDate:refreshDate:

Initializes a new instance.

ParameterDescription
tokenString

The opaque token string.

permissions

The granted permissions. Note this is converted to NSSet and is only an NSArray for the convenience of literal syntax.

declinedPermissions

The declined permissions. Note this is converted to NSSet and is only an NSArray for the convenience of literal syntax.

appID

The app ID.

userID

The user ID.

expirationDate

The optional expiration date (defaults to distantFuture).

refreshDate

The optional date the token was last refreshed (defaults to today).

- (instancetype)
initWithTokenString: (NSString *)tokenString
permissions: (NSArray *)permissions
declinedPermissions: (NSArray *)declinedPermissions
appID: (NSString *)appID
userID: (NSString *)userID
expirationDate: (NSDate *)expirationDate
refreshDate: (NSDate *)refreshDate
NS_DESIGNATED_INITIALIZER;
Discussion:

This initializer should only be used for advanced apps that manage tokens explicitly. Typical login flows only need to use FBSDKLoginManager along with +currentAccessToken.

Declared In: FBSDKAccessToken.h
isEqualToAccessToken:

Compares the receiver to another FBSDKAccessToken

ParameterDescription
token

The other token

- (BOOL) isEqualToAccessToken:(FBSDKAccessToken *)token;
Declared In: FBSDKAccessToken.h
Constants
FBSDKAccessTokenDidChangeNotification
FBSDK_EXTER N NSString *const FBSDKAccessTokenDidChangeNotification;
Discussion:

The userInfo dictionary of the notification will contain keys FBSDKAccessTokenChangeOldKey and FBSDKAccessTokenChangeNewKey.

Declared In: FBSDKAccessToken.h
FBSDKAccessTokenDidChangeUserID
FBSDK_EXTER N NSString *const FBSDKAccessTokenDidChangeUserID;
Discussion:

Token refreshes can occur automatically with the SDK which do not change the user. If you're only interested in user changes (such as logging out), you should check for the existence of this key. The value is a NSNumber with a boolValue.

Declared In: FBSDKAccessToken.h