Skip to content

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étodoRotaDescrição
POST/api/sync/pushrecebe um lote de eventos de um node local
GET/api/sync/pullserve eventos da nuvem após o cursor do node

Enviados com X-Node-Id + X-Node-Secret.

Operacionais (Bearer) ​

MétodoRotaAuthDescrição
POST/api/sync/runsync:rundispara um ciclo push+pull (modo local)
POST/api/sync/confirmsync:runmarca eventos locais como sincronizados
GET/api/sync/statussync:readstatus de sincronização
GET/api/sync/pendingsync:readeventos locais pendentes
GET/api/sync/checkpointsync:readúltimos checkpoints do node
POST/api/sync/errorsync:runreporta um erro de sincronização
GET/api/sync/conflictssync:readlista conflitos (abertos por padrão)
POST/api/sync/conflicts/:id/resolvesync:resolve_conflictresolve 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"
}