# API для разработчиков: уведомления

Документ описывает чтение пользовательских уведомлений, которые сервер индексирует при `AddBlock`.

Текущая операция:

- `GetNotifications`

## 1. `GetNotifications`

Метод читает уведомления текущего пользователя. В `payload.login` можно передать логин явно, но обычно клиент использует авторизованную сессию.

Возвращаются две отдельные ленты:

- `replies` — ответы на сообщения пользователя в каналах и тредах;
- `events` — события добавления в `close_friend`.

### Запрос

```json
{
  "op": "GetNotifications",
  "requestId": "notif-001",
  "payload": {
    "login": "alice",
    "limit": 50
  }
}
```

### Успешный ответ

```json
{
  "op": "GetNotifications",
  "requestId": "notif-001",
  "status": 200,
  "ok": true,
  "payload": {
    "login": "Alice",
    "replies": [
      {
        "kind": "reply",
        "createdAtMs": 1755673200000,
        "sourceLogin": "Bob",
        "sourceBlockchainName": "bob-001",
        "sourceBlockNumber": 42,
        "sourceBlockHash": "ab12...",
        "sourceMsgSubType": 20,
        "sourceText": "Спасибо!",
        "targetLogin": "Alice",
        "targetBlockchainName": "alice-001",
        "targetBlockNumber": 18,
        "targetBlockHash": "cd34..."
      }
    ],
    "events": [
      {
        "kind": "close_friend",
        "createdAtMs": 1755673300000,
        "sourceLogin": "Kate",
        "sourceBlockchainName": "kate-001",
        "sourceBlockNumber": 7,
        "sourceBlockHash": "ef56...",
        "sourceMsgSubType": 10,
        "sourceText": "close_friend",
        "targetLogin": "Alice",
        "targetBlockchainName": "alice-001",
        "targetBlockNumber": 0,
        "targetBlockHash": "0000..."
      }
    ]
  }
}
```

### Примечание

- `replies` заполняется только для `TEXT_REPLY`.
- `events` заполняется только для входящего `CONNECTION_FRIEND` / `close_friend`.
- Другие типы связей в эту ленту не попадают.