Reliable Web Push notifications for Nostr users
Nostria Service provides reliable web push notifications for Nostr users. The service utilizes the Web Push protocol and VAPID (Voluntary Application Server Identification) to deliver secure, verifiable notifications to users across devices.
Receive real-time notifications across devices with the Web Push protocol.
Verifiable and secure notifications with cryptographic verification.
Enhanced notification limits and custom filtering options for premium users.
Control how and when you receive notifications with customizable settings.
The following endpoints are available for developers:
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/status | Get service information and status |
| GET | /api/status/health | Health check endpoint |
| GET | /api/key | Get service public key (VAPID) |
| POST | /api/notification/send | Send notifications to users (API key required) |
| POST | /api/subscription/webpush/:pubkey | Register a web push subscription for a user's device |
| GET | /api/subscription/devices/:pubkey | Get all registered devices for a user |
| GET | /api/subscription/settings/:pubkey | Get a user's notification settings |
| POST | /api/subscription/settings/:pubkey | Update a user's notification settings |
| DELETE | /api/subscription/webpush/:pubkey/:deviceKey | Delete a specific device subscription for a user |
Note: API endpoints require NIP-98 HTTP Authentication.
This API uses NIP-98 HTTP Authentication for secure access to endpoints:
Authorization: Nostr [base64-encoded-event]For more details on implementation, see the NIP-98 Specification.
To use the Nostria Notification Service, you need to:
For developers who want to send notifications, you need to authenticate using the API key. Please contact the service administrator for API access.
Use this form to manually send notifications to users. Requires API key authentication.