Tema
Sincronização
Endpoints de ingestão (autenticados por node) e operacionais (autenticados por usuário). A mecânica está em Sincronização e conflitos.
Ingestão (credencial de node)
| Método | Rota | Descrição |
|---|---|---|
| POST | /api/sync/push | recebe um lote de eventos de um node local |
| GET | /api/sync/pull | serve eventos da nuvem após o cursor do node |
Enviados com X-Node-Id + X-Node-Secret.
Operacionais (Bearer)
| Método | Rota | Auth | Descrição |
|---|---|---|---|
| POST | /api/sync/run | sync:run | dispara um ciclo push+pull (modo local) |
| POST | /api/sync/confirm | sync:run | marca eventos locais como sincronizados |
| GET | /api/sync/status | sync:read | status de sincronização |
| GET | /api/sync/pending | sync:read | eventos locais pendentes |
| GET | /api/sync/checkpoint | sync:read | últimos checkpoints do node |
| POST | /api/sync/error | sync:run | reporta um erro de sincronização |
| GET | /api/sync/conflicts | sync:read | lista conflitos (abertos por padrão) |
| POST | /api/sync/conflicts/:id/resolve | sync:resolve_conflict | resolve um conflito registrado |
Status (exemplo)
json
{
"mode": "online",
"connection": "n/a",
"pendingLocalEvents": 2,
"failedEvents": 0,
"remoteEventsWaiting": 0,
"openConflicts": 0,
"schemaVersion": "0001_init",
"appVersion": "0.1.0"
}