HERE cloud notification service overview
The HERE Cloud Notification Service enables HERE notifications to be transmitted across devices, delivering targeted notifications to users and groups across distributed applications. The service enables server-side applications to send interactive notifications with support for hierarchical organizational structures, flexible targeting options, and cross-platform delivery. Built for enterprise environments, it provides reliable notification delivery with status tracking, user interaction handling, and comprehensive group management capabilities.
We provide two server-side SDKs to interact with the service:
Authentication
The service supports multiple authentication methods to accommodate different security requirements. Basic authentication uses traditional username and password credentials for simple integration scenarios. JWT tokens provide secure authentication for service connections, enabling fine-grained access control and token-based security models.
Connection and targeting
All clients must establish a connection to the service before publishing notifications or receiving events. These connections expire periodically and require applications to handle reconnection gracefully. The service supports flexible targeting that allows you to send notifications to specific users, hierarchical groups, or both simultaneously. You can target groups like 'london' or 'trading-desk' and individual users by their email addresses.
The hierarchical group system supports inheritance, which means targeting a parent group like "UK" will automatically send notifications to all sub-groups including Scotland, England, and their nested groups. This inheritance model provides fine-grained control over notification distribution across complex organizational structures.
In the case of duplication, all target members receive only one notification.
API methods
The service provides five primary methods for interaction. The connect method creates a new connection to the service, while disconnect removes an existing connection. The raiseNotification method sends new notifications to specified targets, and updateNotification allows you to modify existing notifications after they have been sent. Finally, the getStatus method retrieves the current status of previously sent notifications.
Quick start
To begin using the service, install the SDK package. Next, create a CloudNotificationAPI instance and configure connection settings with your platform ID and authentication credentials. After connecting, you can send notifications by specifying targets (groups and/or users) and payload information including title, body, and category.
Notification payloads are structured in the same way as Notification Center objects.
The API provides comprehensive event listeners for incoming notifications, connection expiration events, and disconnection scenarios that require reconnection handling. Proper event handling ensures your application maintains reliable notification delivery even during network interruptions or service maintenance.