ETERA API Documentation

Asynchronous Topic Notification

Queues a topic-based push notification for background processing.

Features:

Topic-based messaging
Background job processing
Automatic retries with exponential backoff
Priority-based processing
Job status tracking

Example Request:

POST /push/async/topic
Authorization: Bearer your-jwt-token
Content-Type: application/json
{
  "topic": "news",
  "title": "Breaking News",
  "body": "Important update available",
  "priority": "high",
  "queueOptions": {
    "priority": 9,
    "maxRetries": 5
  }
}

**Asynchronous Topic Notification** Queues a topic-based push notification for background processing. **Features:** - Topic-based messaging - Background job processing - Automatic retries with exponential backoff - Priority-based processing - Job status tracking **Example Request:** ``` POST /push/async/topic Authorization: Bearer your-jwt-token Content-Type: application/json { "topic": "news", "title": "Breaking News", "body": "Important update available", "priority": "high", "queueOptions": { "priority": 9, "maxRetries": 5 } } ```

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

queueOptionsobjectOptional

Response

This endpoint returns an object.

successboolean

dataobject

errorobject

1	const url = 'https://api.etera.dev/notification/push/async/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	"jobId": "string",
5	"status": "string"
6	},
7	"error": {
8	"message": "string",
9	"code": "string"
10	}
11	}