Skip to content

Device Registration API

In order to receive push notifications from Backendless, a device must be registered using the API documented below. Device registration may optionally include a list of messaging channels and/or an expiration date/time when the registration should be canceled.

Important

Push notifications can be published using either API or Backendless Console. When a push notification is published, it goes through a * messaging channel* . Channels provide a way to establish a level of filtering - devices registered with a channel will receive notifications published to the channel. However, there are other way to narrow down push notification delivery. For example, a push notification may be sent to a specific device or a group of devices.

If no channels are specified in the device registration call, Backendless registers the device with the default channel. If the device registration call references a non-existing channel, Backendless creates the channel and registers the device with it. Registration expiration is a point in time (expressed as a timestamp) when the device registration must expire. Backendless removes the device registration at the specified time and the device no longer receives published push notifications.

In order to receive push notifications on a mobile device, application running on the device must register with Backendless using the API call below:

Method

Blocking API

public void Backendless.Messaging.RegisterDevice( String token )

public void Backendless.Messaging.RegisterDevice( String token, String channel )

public void Backendless.Messaging.RegisterDevice( String token, List<String> channels )

public void Backendless.Messaging.RegisterDevice( String token, List<String> channels, DateTime? expiration )

Non-Blocking API

public Task RegisterDeviceAsync( String token )

public Task RegisterDeviceAsync( String token, String channel )

public Task RegisterDeviceAsync( String token, List<String> channels )

public Task RegisterDeviceAsync( String token, List<String> channels, DateTime? expiration)

where:

Argument                Description
token A token assigned by the push notification service provider (Google Cloud Messaging or Apple Push Notification Service).
channel The name of the channel to register the device with.
channels A collection of messaging channels the device registration will be associated with. Messages published to the channels will be delivered to the associated devices. For the methods without the argument, Backendless registers the device with the default channel.
expiration A timestamp when the device registration should expire.

Return value

Returns an object containing mappings between the device registration identifier and the channel the device has registered with:

{  
  registrationId : "DDB739FA-7B8C-A865-FFBC-63B746A1E200::channel1,1FC8C91C-A0DD-C130-FFCB-88C34A235E00::channel2"  
}

Example

Blocking API

// Example 1
String token = "TOKEN FROM FIREBASE";

Backendless.Messaging.RegisterDevice(token);



 // Example 2
String token = "TOKEN FROM FIREBASE";
String channelToRegister = "default";

Backendless.Messaging.RegisterDevice(token, channelToRegister);



 // Example 3
String token = "TOKEN FROM FIREBASE";
List<String> channelsToRegister = new List<String> { "default", "special_channel" };

Backendless.Messaging.RegisterDevice(token, channelsToRegister);



 // Example 4

String token = "TOKEN FROM FIREBASE";
List<String> channelsToRegister = new List<String> { "default", "special_channel" };
DateTime dateOfExpiration = DateTime.Now.AddDays(14);

Backendless.Messaging.RegisterDevice(token, channelsToRegister, dateOfExpiration);

Non-Blocking API

// Example 1
String token = "TOKEN FROM FIREBASE";

await Backendless.Messaging.RegisterDeviceAsync(token);


 // Example 2
String token = "TOKEN FROM FIREBASE";
String channelToRegister = "default";

await Backendless.Messaging.RegisterDeviceAsync(token, channelToRegister);


 // Example 3
String token = "TOKEN FROM FIREBASE";
List<String> channelsToRegister = new List<String> { "default", "special_channel" };

await Backendless.Messaging.RegisterDeviceAsync(token, channelsToRegister);


 // Example 4
String token = "TOKEN FROM FIREBASE";
List<String> channelsToRegister = new List<String> { "default", "special_channel" };
DateTime dateOfExpiration = DateTime.Now.AddDays(14);

await Backendless.Messaging.RegisterDeviceAsync(token, channelsToRegister, dateOfExpiration);

Errors

The following errors may occur during the message publishing API call. See the Error Handling section for details on how to retrieve the error code when the server returns an error:

Error Code
Description
5004
Invalid expiration date. The expiration date must be after the current time.
8000
Property value exceeds the length limit. Error message should contain additional details about the violating property.

Codeless Reference

push_device_registration_api_1

where:

Argument                Description
channel name A list of messaging channels the device registration will be associated with. Messages published to the channels will be delivered to the associated devices. If no values are passed to this parameter, then Backendless registers the device with the default channel.
return result Returns an object with the registrationId parameter, containing a Map between Backendless channel name (key name in the map) and the registration ID of the device for that channel (value assigned to the key). When a device is registered with multiple Backendless messaging channels, this map will contain a mapping for each channel.

The example below registers the device with the "ads" and "discount" channels:

push_device_registration_api_2