SHA256
82 lines
2.3 KiB
Markdown
82 lines
2.3 KiB
Markdown
# 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`.
|
|
- Другие типы связей в эту ленту не попадают.
|