HTTP API

REST API reference for programmatic access to Raceway.

Base URL

http://localhost:8080

Authentication

Include API key in requests if auth is enabled:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  http://localhost:8080/api/traces

Endpoints

See detailed API reference:

• Events API - Event ingestion and retrieval
• Traces API - Trace management
• Analysis API - Critical path, anomalies, races
• Services API - Service metrics

Quick Reference

Health Check

GET /health

Ingest Events

POST /events
Content-Type: application/json

{
  "trace_id": "abc123",
  "event_id": "evt-001",
  "kind": "HttpRequest",
  ...
}

List Traces

GET /api/traces?page=1&per_page=20

Get Trace Analysis

GET /api/traces/{trace_id}

Get Critical Path

GET /api/traces/{trace_id}/critical-path

Get Anomalies

GET /api/traces/{trace_id}/anomalies

Get Race Conditions

GET /api/distributed/global-races

Rate Limiting

Default: 1000 requests/minute

Headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1672531200

Error Responses

{
  "error": "Error message"
}

Status codes:

• 400 - Bad Request
• 401 - Unauthorized
• 404 - Not Found
• 429 - Too Many Requests
• 500 - Internal Server Error

Next Steps

• API Reference - Complete API documentation
• SDKs - Use language-specific SDKs
• Security - API authentication