Skip to content

API.md

Latest commit

 

History

History
65 lines (43 loc) · 1.04 KB

API.md

File metadata and controls

65 lines (43 loc) · 1.04 KB

API - Mercury Core

Base local padrão: http://127.0.0.1:8080

Endpoints

GET /health

Retorna status básico.

Exemplo de resposta:

{"status":"ok"}

POST /api/v1/ingest

Ingere lote de registros numéricos.

Body esperado:

{
  "batchId": "demo-1",
  "records": [
    {"id":"a1","value":12.3,"payload":"abc","timestamp":1710000000}
  ]
}

Campos relevantes:

  • records é obrigatório.
  • timestamp ausente cai em fallback para timestamp atual.
  • payload é usado para contabilizar bytes.

GET /api/v1/cache?batchId=<id>

Consulta resultado de lote no cache.

  • 200: hit
  • 404: miss
  • 400: sem batchId

GET /api/v1/benchmark

Exibe snapshot de observabilidade:

  • requestsTotal
  • requestsError
  • ingestedRecords
  • cacheHits
  • cacheMisses
  • meanLatencyMs
  • requestsPerSecond
  • cacheItems

POST /api/v1/simulate?ops=<n>&workers=<n>

Executa simulação de concorrência interna.

GET /api/v1/stream?count=<n>

Retorna stream NDJSON em chunked transfer encoding.