ETERA API Documentation

Features:

Register device tokens for iOS, Android, and Web platforms
Token validation with Firebase
Device information tracking
User association with authenticated user
Automatic token management and cleanup

Platform Support:

iOS: APNs device tokens
Android: FCM registration tokens
Web: Web Push subscription tokens

Authentication:

Requires valid Bearer token
Token is associated with authenticated user
Test tokens available for development: test-jwt-token, agent-jwt-token

Token Management:

Tokens are validated with Firebase before storage
Duplicate tokens are handled gracefully
Tokens expire after 30 days of inactivity
Device information is stored for analytics

Use Cases:

Initial app installation
Token refresh after app updates
Multi-device support per user
Platform-specific notification targeting

Example Request:

1 {
2   "token": "fcm_token_here",
3   "platform": "android",
4   "appVersion": "1.0.0",
5   "deviceId": "device_123",
6   "deviceInfo": {
7     "model": "Pixel 7",
8     "osVersion": "Android 13",
9     "appBuild": "100",
10     "timezone": "America/New_York"
11   }
12 }

Register a device token for push notifications. **Features:** - Register device tokens for iOS, Android, and Web platforms - Token validation with Firebase - Device information tracking - User association with authenticated user - Automatic token management and cleanup **Platform Support:** - **iOS**: APNs device tokens - **Android**: FCM registration tokens - **Web**: Web Push subscription tokens **Authentication:** - Requires valid Bearer token - Token is associated with authenticated user - Test tokens available for development: `test-jwt-token`, `agent-jwt-token` **Token Management:** - Tokens are validated with Firebase before storage - Duplicate tokens are handled gracefully - Tokens expire after 30 days of inactivity - Device information is stored for analytics **Use Cases:** - Initial app installation - Token refresh after app updates - Multi-device support per user - Platform-specific notification targeting **Example Request:** ```json { "token": "fcm_token_here", "platform": "android", "appVersion": "1.0.0", "deviceId": "device_123", "deviceInfo": { "model": "Pixel 7", "osVersion": "Android 13", "appBuild": "100", "timezone": "America/New_York" } } ```

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

tokenstringRequired>=1 character

platform"ios" or "android" or "web"Required

appVersionstringOptional

deviceIdstringOptional

deviceInfoobjectOptional

Response

This endpoint returns an object.

successboolean

dataobject or null

errorobject or null

1	curl -X POST https://api.etera.dev/notification/push/register-token \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"token": "string",
6	"platform": "ios"
7	}'

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

1	{
2	"token": "fcm_token_here",
3	"platform": "android",
4	"appVersion": "1.0.0",
5	"deviceId": "device_123",
6	"deviceInfo": {
7	"model": "Pixel 7",
8	"osVersion": "Android 13",
9	"appBuild": "100",
10	"timezone": "America/New_York"
11	}
12	}