Finance OS / API

Notifications

GET /api/mobile/notifications
⚷ Bearer Token

Список уведомлений пользователя

Пагинированный список in-app уведомлений: депозиты, выводы, KYC-вердикты, trading alerts, system messages.

Query parameters

Name Type Required Description
page integer optional Номер страницы.
Default: 1
per_page integer optional Максимум 100.
Default: 20
filter[unread] boolean optional Только непрочитанные.
filter[type] string optional deposit, withdraw, kyc, trading, system, marketing.

Response

Responses

{
  "data": [
    {
      "id": "ntf_5f8d7a3c...",
      "type": "deposit",
      "title": "Депозит получен",
      "body": "100 USDT зачислено на ваш счёт",
      "icon": "deposit",
      "read_at": null,
      "created_at": "2026-05-27T14:23:00Z",
      "action_url": "/transactions/tx_8e23f...",
      "action_label": "Открыть",
      "data": {
        "transaction_id": "tx_8e23f...",
        "amount": "100.000000",
        "currency": "USDT"
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 45,
    "unread_count": 3
  }
}

Отметить как прочитанное

Отдельные endpoints:

  • POST /api/mobile/notifications/{id}/read — одна нотификация
  • POST /api/mobile/notifications/read-all — все непрочитанные

Реалтайм

Для получения новых уведомлений в реальном времени подключайтесь к Laravel Reverb (WebSocket):

// Подписка на персональный канал пользователя
window.Echo.private(`user.${userId}.notifications`)
    .listen('NotificationCreated', (e) => {
        showToast(e.notification);
    });
ℹ
Reverb endpoint
WebSocket URL: wss://fin-os.io/app/{REVERB_APP_KEY}. App key выдаётся в ЛК → API Keys → Reverb. Authentication через тот же Bearer token.