Добавить периодический sync блокчейнов каждые 12 часов

Dev_Docs/API/04_Add_Block_to_Blockchain_API.md

@@ -1,6 +1,11 @@
-# API для разработчиков: 04 — Добавление блока в блокчейн (AddBlock)
+# API для разработчиков: 04 — Запись и чтение блока блокчейна
 
-Документ описывает **текущий рабочий формат** сетевого вызова `AddBlock`, который используется для записи **любого** блока в блокчейн пользователя.
+Документ описывает **текущий рабочий формат** сетевых вызовов:
+
+- `AddBlock` — запись любого блока в блокчейн пользователя;
+- `GetBlockchainBlock` — публичное чтение одного конкретного блока по имени цепочки и номеру.
+
+`GetBlockchainBlock` нужен в том числе для межсерверной синхронизации и для открытого чтения публичного блокчейна по одному блоку.
 
 > Важный принцип: на уровне JSON API сейчас есть **один универсальный метод** записи — `AddBlock`.
 > Конкретный смысл записи задаётся типом самого бинарного блока (`type/subType/version` в заголовке блока).
@@ -174,3 +179,60 @@
 - сейчас нет серверной ACL-политики чтения параметров (в MVP их может читать любой клиент, который знает `login`);
 - нет валидации формата значений для конкретных ключей (телефон, URL и т.д. проверяются только на стороне клиента);
 - нет отдельного индекса/поиска по этим полям — только точечное чтение и listing по `login`.
+
+---
+
+## 9. `GetBlockchainBlock`
+
+### Назначение
+
+Публичное чтение одного конкретного блока из цепочки.
+
+Нужно для:
+
+- открытого чтения блокчейна по одному блоку;
+- межсерверной синхронизации;
+- восстановления/докачки отсутствующего хвоста цепочки.
+
+### JSON формат запроса
+
+`op = "GetBlockchainBlock"`.
+
+```json
+{
+  "op": "GetBlockchainBlock",
+  "requestId": "req-2001",
+  "payload": {
+    "blockchainName": "alice-001",
+    "blockNumber": 12
+  }
+}
+```
+
+Поля `payload`:
+
+- `blockchainName` — обязательно, формат `login-NNN`.
+- `blockNumber` — обязательно, номер блока в цепочке, `>= 0`.
+
+### Успешный ответ
+
+```json
+{
+  "op": "GetBlockchainBlock",
+  "requestId": "req-2001",
+  "status": 200,
+  "ok": true,
+  "payload": {
+    "blockchainName": "alice-001",
+    "blockNumber": 12,
+    "blockHash": "9f0eaabbccddeeff00112233445566778899aabbccddeeff0011223344556677",
+    "blockBytesB64": "AAAB..."
+  }
+}
+```
+
+### Ошибки
+
+- `400 / BAD_FIELDS` — некорректные `blockchainName` или `blockNumber`.
+- `404 / BLOCK_NOT_FOUND` — такого блока нет.
+- `500 / INTERNAL_ERROR` — внутренняя ошибка сервера.