Документировать API и сервис агента-кодера

2026-05-24 08:04:44 +03:00
parent aa2644d812
commit 4b371e142d
53 changed files with 4317 additions and 18 deletions
@@ -1,7 +1,7 @@
 # 06. Channels Read API

 ## Человеко-читаемое объяснение
-Эти 3 функции — это **чтение данных каналов** для UI:
+Эти функции — это **чтение данных каналов** для UI:

 1. `ListSubscriptionsFeed` — отдает данные для экрана списка каналов:
   - ваши каналы (личный + созданные вами),
@@ -14,6 +14,12 @@
 3. `GetMessageThread` — отдает дерево обсуждения вокруг конкретного сообщения:
   предки, фокус-сообщение, потомки.

+4. `GetChannelsCounters` — отдает счетчики разделов каналов для пользователя.
+
+5. `ListGroupChats200` — отдает список групповых чатов типа `200`.
+
+6. `GetGroupDialog` — отдает сообщения конкретного группового чата типа `200`.
+
 > На первом этапе мы **не используем курсоры** (`nextCursor`) и загружаем полные списки.

 ---
@@ -198,6 +204,126 @@

 ---

+## 4) GetChannelsCounters
+
+### Request
+```json
+{
+  "op": "GetChannelsCounters",
+  "requestId": "req-4",
+  "payload": {
+    "login": "Alice"
+  }
+}
+```
+
+### Response (success)
+```json
+{
+  "op": "GetChannelsCounters",
+  "requestId": "req-4",
+  "status": 200,
+  "ok": true,
+  "payload": {
+    "login": "Alice",
+    "feedCount": 12,
+    "dialogs100Count": 3,
+    "groupChats200Count": 4,
+    "myChannelsCount": 2
+  }
+}
+```
+
+---
+
+## 5) ListGroupChats200
+
+### Request
+```json
+{
+  "op": "ListGroupChats200",
+  "requestId": "req-5",
+  "payload": {
+    "login": "Alice"
+  }
+}
+```
+
+### Response (success)
+```json
+{
+  "op": "ListGroupChats200",
+  "requestId": "req-5",
+  "status": 200,
+  "ok": true,
+  "payload": {
+    "login": "Alice",
+    "chats": [
+      {
+        "ownerLogin": "Alice",
+        "ownerBlockchainName": "alice-001",
+        "channelRootBlockNumber": 123,
+        "channelRootBlockHash": "...",
+        "channelName": "team",
+        "chatTitle": "Team chat",
+        "membersCount": 3,
+        "updatedAtMs": 1760000000000
+      }
+    ]
+  }
+}
+```
+
+---
+
+## 6) GetGroupDialog
+
+### Request
+```json
+{
+  "op": "GetGroupDialog",
+  "requestId": "req-6",
+  "payload": {
+    "login": "Alice",
+    "group": {
+      "ownerBlockchainName": "alice-001",
+      "channelRootBlockNumber": 123
+    }
+  }
+}
+```
+
+### Response (success)
+```json
+{
+  "op": "GetGroupDialog",
+  "requestId": "req-6",
+  "status": 200,
+  "ok": true,
+  "payload": {
+    "group": {
+      "ownerLogin": "Alice",
+      "ownerBlockchainName": "alice-001",
+      "channelRootBlockNumber": 123,
+      "channelName": "team",
+      "chatTitle": "Team chat"
+    },
+    "messages": [
+      {
+        "authorLogin": "Bob",
+        "authorBlockchainName": "bob-001",
+        "blockNumber": 140,
+        "blockHash": "...",
+        "createdAtMs": 1760000000000,
+        "text": "Привет"
+      }
+    ]
+  }
+}
+```
+
+---
+
 ## Reason codes
 - `bad_fields`
 - `user_not_found`