API Reference

http://localhost:8080/api/v1

# JWT Token
Authorization: Bearer <access_token>

# API Key
X-Glintlog-Key: <api_key>

GET /health

{
  "status": "ok",
  "version": "0.0.1_alpha"
}

POST /api/v1/setup/init

{
  "email": "admin@example.com",
  "password": "secure-password"
}

POST /api/v1/auth/login

{
  "email": "user@example.com",
  "password": "password"
}

{
  "access_token": "eyJhbG...",
  "refresh_token": "eyJhbG...",
  "expires_in": 3600
}

POST /api/v1/auth/refresh

{
  "refresh_token": "eyJhbG..."
}

GET /api/v1/auth/me

{
  "id": "user_abc123",
  "email": "user@example.com",
  "role": "admin",
  "created_at": "2024-01-15T10:30:00Z"
}

POST /api/v1/auth/logout

POST /api/v1/auth/password-reset/request

{
  "email": "user@example.com"
}

POST /api/v1/auth/password-reset/complete

{
  "token": "reset-token",
  "new_password": "new-password"
}

GET /api/v1/logs

{
  "logs": [
    {
      "timestamp": "2024-01-15T10:30:00.123Z",
      "service_name": "api-server",
      "severity": "INFO",
      "body": "Request processed",
      "trace_id": "abc123...",
      "span_id": "def456...",
      "attributes": {"key": "value"}
    }
  ],
  "total": 1523,
  "has_more": true
}

GET /api/v1/logs/tail

data: {"timestamp":"2024-01-15T10:30:00Z","service_name":"api-server","severity":"INFO","body":"New entry"}

data: {"timestamp":"2024-01-15T10:30:01Z","service_name":"api-server","severity":"DEBUG","body":"Another entry"}

GET /api/v1/logs/histogram

{
  "buckets": [
    {"timestamp": "2024-01-15T10:00:00Z", "count": 1523},
    {"timestamp": "2024-01-15T11:00:00Z", "count": 892}
  ]
}

GET /api/v1/traces

{
  "traces": [
    {
      "trace_id": "abc123...",
      "root_span_name": "HTTP POST /orders",
      "services": ["api-gateway", "order-service"],
      "duration_ms": 250,
      "span_count": 5,
      "status": "OK",
      "started_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 156,
  "has_more": true
}

GET /api/v1/traces/{traceId}

{
  "trace_id": "abc123...",
  "spans": [
    {
      "span_id": "def456...",
      "parent_span_id": null,
      "name": "HTTP POST /orders",
      "service_name": "api-gateway",
      "start_time": "2024-01-15T10:30:00.000Z",
      "end_time": "2024-01-15T10:30:00.250Z",
      "duration_ms": 250,
      "status": "OK",
      "attributes": {}
    }
  ],
  "services": ["api-gateway", "order-service"],
  "total_duration_ms": 250
}

GET /api/v1/services

{
  "services": [
    {"name": "api-server", "log_count": 15234},
    {"name": "worker", "log_count": 8921}
  ]
}

GET /api/v1/stats

{
  "total_logs": 26496,
  "total_traces": 1523,
  "services": 3,
  "storage_bytes": 52428800,
  "oldest_log": "2024-01-01T00:00:00Z",
  "newest_log": "2024-01-15T10:30:00Z"
}

GET /api/v1/admin/metrics

{
  "cpu_percent": 12.5,
  "memory_percent": 45.2,
  "memory_used_bytes": 1073741824,
  "goroutines": 42,
  "uptime_seconds": 86400
}

GET /api/v1/admin/storage

{
  "database_size_bytes": 52428800,
  "partitions": [
    {"name": "logs_2024_01_15", "row_count": 15234, "size_bytes": 5242880},
    {"name": "logs_2024_01_14", "row_count": 12000, "size_bytes": 4194304}
  ]
}

DELETE /api/v1/admin/logs

POST /api/v1/admin/compact

GET /api/v1/admin/users
POST /api/v1/admin/users
DELETE /api/v1/admin/users/{userId}

GET /api/v1/admin/api-keys
POST /api/v1/admin/api-keys
DELETE /api/v1/admin/api-keys/{keyId}

GET /api/v1/admin/settings
PUT /api/v1/admin/settings

{
  "retention_days": 30,
  "batch_size": 1000,
  "flush_interval": "5s"
}

{
  "error": "unauthorized",
  "message": "Invalid or expired token"
}