@interface FIRInstanceID : NSObject
Instance ID provides a unique identifier for each app instance and a mechanism to authenticate and authorize actions (for example, sending an FCM message).
Once an InstanceID is generated, the library periodically sends information about the
application and the device where it’s running to the Firebase backend. To stop this. see
Instance ID is long lived but, may be reset if the device is not used for
a long time or the Instance ID service detects a problem.
If Instance ID is reset, the app will be notified via
If the Instance ID has become invalid, the app can request a new one and
send it to the app server.
To prove ownership of Instance ID and to allow servers to access data or
services associated with the app, call
+ (nonnull instancetype)instanceID;
A shared instance of FIRInstanceID.
Unavailable. Use +instanceID instead.
- (nonnull instancetype)init;
Returns a result of app instance identifier InstanceID and a Firebase Messaging scoped token. param handler The callback handler invoked when an app instanceID and a default token are generated and returned. If instanceID and token fetching fail for some reason the callback is invoked with nil
resultand the appropriate error.
- (void)instanceIDWithHandler:(nonnull FIRInstanceIDResultHandler)handler;
Returns a token that authorizes an Entity (example: cloud service) to perform an action on behalf of the application identified by Instance ID.
This is similar to an OAuth2 token except, it applies to the application instance instead of a user.
This is an asynchronous call. If the token fetching fails for some reason we invoke the completion callback with nil
tokenand the appropriate error.
This generates an Instance ID if it does not exist yet, which starts periodically sending information to the Firebase backend (see
Note, you can only have one
deleteTokencall for a given authorizedEntity and scope at any point of time. Making another such call with the same authorizedEntity and scope before the last one finishes will result in an error with code
- (void)tokenWithAuthorizedEntity:(nonnull NSString *)authorizedEntity scope:(nonnull NSString *)scope options:(nullable NSDictionary *)options handler:(nonnull FIRInstanceIDTokenHandler)handler;
Entity authorized by the token.
Action authorized for authorizedEntity.
The extra options to be sent with your token request. The value for the
apns_tokenshould be the NSData object passed to the UIApplicationDelegate’s
didRegisterForRemoteNotificationsWithDeviceTokenmethod. The value for
apns_sandboxshould be a boolean (or an NSNumber representing a BOOL in Objective C) set to true if your app is a debug build, which means that the APNs device token is for the sandbox environment. It should be set to false otherwise. If the
apns_sandboxkey is not provided, an automatically-detected value shall be used.
The callback handler which is invoked when the token is successfully fetched. In case of success a valid
nilerror are returned. In case of any error the
tokenis nil and a valid
erroris returned. The valid error codes have been documented above.
Revokes access to a scope (action) for an entity previously authorized by
This is an asynchronous call. Call this on the main thread since InstanceID lib is not thread safe. In case token deletion fails for some reason we invoke the
handlercallback passed in with the appropriate error code.
Note, you can only have one
deleteTokencall for a given authorizedEntity and scope at a point of time. Making another such call with the same authorizedEntity and scope before the last one finishes will result in an error with code
- (void)deleteTokenWithAuthorizedEntity:(nonnull NSString *)authorizedEntity scope:(nonnull NSString *)scope handler: (nonnull FIRInstanceIDDeleteTokenHandler) handler;
Entity that must no longer have access.
Action that entity is no longer authorized to perform.
The handler that is invoked once the unsubscribe call ends. In case of error an appropriate error object is returned else error is nil.
Asynchronously fetch a stable identifier that uniquely identifies the app instance. If the identifier has been revoked or has expired, this method will return a new identifier.
Once an InstanceID is generated, the library periodically sends information about the application and the device where it’s running to the Firebase backend. To stop this. see
- (void)getIDWithHandler:(nonnull FIRInstanceIDHandler)handler;
The handler to invoke once the identifier has been fetched. In case of error an appropriate error object is returned else a valid identifier is returned and a valid identifier for the application instance.
Resets Instance ID and revokes all tokens.
This method also triggers a request to fetch a new Instance ID and Firebase Messaging scope token. Please listen to kFIRInstanceIDTokenRefreshNotification when the new ID and token are ready.
This stops the periodic sending of data to the Firebase backend that began when the Instance ID was generated. No more data is sent until another library calls Instance ID internally again (like FCM, RemoteConfig or Analytics) or user explicitly calls Instance ID APIs to get an Instance ID and token again.
- (void)deleteIDWithHandler:(nonnull FIRInstanceIDDeleteHandler)handler;