Installation.findByApp(deviceType, appId, [appVersion], cb)

Find installations by application id/version

Arguments
Name Type Description
deviceType String

The device type

appId String

The application id

[appVersion] String

The application version

cb Function

The callback function

Callback
Name Type Description
err Error or String

The error object

installations Array.<Installation>

The selected installations

Installation.findByUser(userId, deviceType, cb, cb)

Find installations by user id

Arguments
Name Type Description
userId String

The user id

deviceType String

The device type

cb Function

The callback function

cb Function

The callback function

Callback
Name Type Description
err Error or String

The error object

installations Array.<Installation>

The selected installations

Installation.findBySubscriptions(subscriptions, deviceType, cb)

Find installations by subscriptions

Arguments
Name Type Description
subscriptions String or Array.<String>

A list of subscriptions

deviceType String

The device type

cb Function

The callback function

Callback
Name Type Description
err Error or String

The error object

installations Array.<Installation>

The selected installations

deviceType

The device type such as ios.

deviceToken

The device token as provided by GCM/APN/etc.

alert

(iOS only) The notification's message.

badge

(iOS only) The value indicated in the top right corner of the app icon. This can be set to a value or to -1 in order to increment the current value by 1.

sound

(iOS only) The name of a sound file in the application bundle.

collapseKey

(Android only) An arbitrary string (such as "Updates Available") that is used to collapse a group of like messages when the device is offline, so that only the last message gets sent to the client.

delayWhileIdle

(Android only) Indicates that the message should not be sent immediately if the device is idle. The server will wait for the device to become active, and then only the last message for each collapse_key value will be sent.

created

The date that the notification is created.

modified

The date that the notifcation is modified.

scheduledTime

The time that the notification should be sent. (not supported yet)

expirationTime

The time that the notification should be expired.

expirationInterval

The expiration interval in seconds. The interval starts at the time when the notification is sent to the push notification provider.

status

The status of the notification. (not supported yet)

Class: PushManager(settings)

Arguments
Name Type Description
settings Object

The push settings

Returns
Name Type Description
result PushManager

Class: PushManager Instance Methods

pushManager.configureApplication(appId)

Lookup or set up push notification service for the given appId

Arguments
Name Type Description
appId String

The application id

Returns
Name Type Description
result

pushManager.configureProvider(deviceType, pushSettings)

Configure push notification for a given device type. Return null when no provider is registered for the device type.

Arguments
Name Type Description
deviceType String

The device type

pushSettings Object

The push settings

Returns
Name Type Description
result

pushManager.notify(installation, notification, cb)

Push a notification to the given installation. This is a low-level function used by the other higher-level APIs like notifyById and notifyByQuery.

Arguments
Name Type Description
installation Installation

Installation instance - the recipient.

notification Notification

The notification to send.

cb function(Error|undefined)

pushManager.notifyById(installationId, notification, cb)

Push a notification to the device with the given registration id.

Arguments
Name Type Description
installationId Object

Registration id created by call to Installation.create().

notification Notification

The notification to send.

cb function(Error|undefined)

pushManager.notifyByQuery(installationQuery, notification, cb)

Push a notification to all installations matching the given query.

Arguments
Name Type Description
installationQuery Object

Installation query, e.g. { appId: 'iCarsAppId', userId: 'jane.smith.id' }

notification Notification

The notification to send.

cb function(Error|undefined)

pushManager.notifyMany(application, type, device, notification, cb)

Push notification to installations for given devices tokens, device type and app.

Arguments
Name Type Description
application appId

id

type deviceType

of device (android, ios )

device deviceTokens

tokens of recipients.

notification Notification

The notification to send.

cb function(Error|undefined)