Nokia Notifications developer guide

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.

Figure 1. Nokia Notifications overview.

Figure 1. Nokia Notifications overview.

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.

Prerequisites: Nokia Developer account

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:

  • Navigate to developer.nokia.com.
  • Click Sign into your Account or Register in the top-left corner.
  • A dialog with sign in and register options is shown (see figure 2).
    • If you have a Nokia account, login by entering your credentials and then clicking the Sign in button.
    • If you do not have a Nokia account, create one now by clicking the Register button.

      Figure 2. Sign in to Nokia form.

      Figure 2. Sign in to Nokia form.

  • After logging in with Nokia account: Create a new Nokia Developer account or link an existing Nokia Developer account to your Nokia account.
  • Complete Nokia Developer signup process.
  • Access the developer console using your Nokia account credentials.

Step 1. Create a notifications service

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.

Figure 3. My services tab on the Nokia Notifications developer console page.

Figure 3. My services tab on the Nokia Notifications developer console page.

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.

Figure 4. Creating a notifications service.

Figure 4. Creating a notifications service.

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.

Figure 5. A notifications service created.

Figure 5. A notifications service created.

Step 2. Start implementing the client side code and the backend server

After the notification service has been created, you can start implementing the client side code and the backend server. For detailed information, please see the API guides:


Last updated 12 August 2014

Back to top

Was this page helpful?

Your feedback about this content is important. Let us know what you think.

 

Thank you!

We appreciate your feedback.

×