ETERA API Documentation

Subscribe one or more device tokens to a Firebase topic.

Features:

Bulk subscription of multiple tokens
Automatic topic creation if it doesn’t exist
Success/failure count for each operation
Idempotent operation (safe to retry)

Topic Naming:

Use descriptive names (e.g., “news”, “sports”, “offers”)
Support hierarchical topics (e.g., “news.sports.football”)
Topics are case-sensitive
Maximum topic name length: 900 characters

Management:

Devices can be subscribed to multiple topics
Subscriptions persist across app installations
Topics automatically clean up unused subscriptions

Subscribe one or more device tokens to a Firebase topic. **Features:** - Bulk subscription of multiple tokens - Automatic topic creation if it doesn't exist - Success/failure count for each operation - Idempotent operation (safe to retry) **Topic Naming:** - Use descriptive names (e.g., "news", "sports", "offers") - Support hierarchical topics (e.g., "news.sports.football") - Topics are case-sensitive - Maximum topic name length: 900 characters **Management:** - Devices can be subscribed to multiple topics - Subscriptions persist across app installations - Topics automatically clean up unused subscriptions

1	const url = 'https://api.etera.dev/notification/push/topic/subscribe';
2	const options = {
3	method: 'POST',
4	headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5	body: '{"tokens":["string"],"topic":"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	"successCount": 1.1,
5	"failureCount": 1.1
6	},
7	"error": {
8	"message": "string",
9	"code": "string"
10	}
11	}

Authentication

Request

Response

Authentication

Request

Response