Finance OS / API

Register Push Token

POST /api/mobile/push-token
⚷ Bearer Token

Зарегистрировать токен для push-уведомлений

Сохраняет FCM (Android, Web) или APNs (iOS) push-токен устройства, чтобы Finance OS мог присылать push-уведомления о депозитах, выводах и trading-алертах.

Request body

Name Type Required Description
token string required FCM/APNs token, полученный от Firebase SDK или Apple APNs.
provider string required fcm (Android/Web) или apns (iOS).
device_id string optional Уникальный ID устройства (для дедупликации). По умолчанию SHA-256 от token.
platform string optional android, ios, web, desktop.
app_version string optional Версия приложения для дебага: 1.4.2.

Response

Responses

{
  "data": {
    "id": "ptk_5f8d7a3c...",
    "device_id": "device-abc-123",
    "platform": "ios",
    "provider": "apns",
    "registered_at": "2026-05-27T14:23:00Z"
  },
  "message": "Push token registered successfully."
}
{
  "message": "The given data was invalid.",
  "errors": {
    "token": ["The token field is required."],
    "provider": ["The selected provider is invalid."]
  }
}

Lifecycle

  • FCM/APNs токены ротируются операционкой устройства — пересохраняйте при каждом старте приложения.
  • Finance OS автоматически удаляет токены, которые FCM/APNs возвращает как INVALID или NOT_REGISTERED.
  • Для удаления токена вручную (при logout): DELETE /api/mobile/push-token/{id}.
✦
Опционально
Push-токены — для нативных приложений. В вебе используйте Laravel Reverb (WebSocket) — он работает в открытой вкладке без отдельной подписки.