Nokia Notifications enables real-time push notifications to your application running on Nokia X software platform. Notification is a message that is sent from a specific notification service to an application installed on the device. Nokia Notifications API consists of two parts: Nokia Notifications Client API (Client API) is the Java API enabling an application to register to a service, and receive and handle notifications. Nokia Notifications Service API (Service API) defines the communication method between a 3rd party service and Nokia Notifications service.
The process of receiving notifications is straightforward. The application, implementing Client API, registers itself for receiving notifications by sending service specific sender identification (sender ID) to Nokia Notifications server. Nokia Notifications server responds by sending a device specific registration identification (registration ID, RID) to the client device. The client application then provides the RID for the 3rd party server, which implements Service API. Finally, the 3rd party server can send notifications, via Nokia Notifications server, for the devices whose registration ID it knows. It is the responsibility of the developer to implement a) client application with Client API and b) server with Service API.
To get started with adding Nokia Notifications to your application, follow the steps defined below.
You need to have a Nokia Developer account linked to your Nokia account (note that these are two different things) to access the Nokia Notifications developer console. The console is used to create and manage your notification services and for sending test notifications. If you do not have an existing Nokia Developer account linked to your Nokia account, do the following:
If you do not have a Nokia account, create one now by clicking the Register button.
Note: Internet Explorer has compatibility issues with the current implementation of the developer console. We recommend that you use some other browser to access the console, e.g. Firefox.
Navigate to the Nokia Notifications developer console (https://console.push.nokia.com). After possible queries and after the page has loaded, select My services tab on the developer console main page as shown in the figure below.
Enter the desired service identification name to the Sender ID text box, add service description, and click Create (see figure 5). If the name you entered is not available, an error message will be shown to you.
Note: Old service IDs, which have been created earlier for Symbian, Series 40, or Nokia Asha software platform, cannot be used with the version 2.0 of the Nokia Notifications API.
If the registration of your service is successful, the page will show you your API key. Make good note of it, you need it whenever sending notifications.
Last updated 12 August 2014