ETERA API Documentation

Send push notifications to all devices subscribed to a topic.

Features:

Topic-based messaging for scalable notifications
No need to manage individual device tokens
Automatic delivery to all subscribed devices
Same rich notification features as direct messaging

Use Cases:

News updates by category
Sports scores by team
Product announcements by interest
Regional notifications

Topic Management:

Topics are created automatically when first used
Devices can subscribe/unsubscribe to topics
Topics support hierarchical naming (e.g., “sports.football.team1”)

Send push notifications to all devices subscribed to a topic. **Features:** - Topic-based messaging for scalable notifications - No need to manage individual device tokens - Automatic delivery to all subscribed devices - Same rich notification features as direct messaging **Use Cases:** - News updates by category - Sports scores by team - Product announcements by interest - Regional notifications **Topic Management:** - Topics are created automatically when first used - Devices can subscribe/unsubscribe to topics - Topics support hierarchical naming (e.g., "sports.football.team1")

Authentication

AuthorizationBearer

JWT token for authentication. Use ‘test-jwt-token’ for development.

Request

This endpoint expects an object.

topicstringRequired>=1 character

titlestringRequired>=1 character

bodystringRequired>=1 character

dataobjectOptional

imageUrlstringOptionalformat: "uri"

clickActionstringOptional

badgedoubleOptional>=0

soundstringOptional

priority"high" or "normal"Optional

timeToLivedoubleOptional0-2419200

collapseKeystringOptional

Response

This endpoint returns an object.

successboolean

dataobject

errorobject

1	const url = 'https://api.etera.dev/notification/push/send-topic';
2	const options = {
3	method: 'POST',
4	headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5	body: '{"topic":"string","title":"string","body":"string"}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}

1	{
2	"success": true,
3	"data": {
4	"success": true,
5	"messageId": "string"
6	},
7	"error": {
8	"message": "string",
9	"code": "string"
10	}
11	}