API Reference

All API endpoints are served on the dashboard host (default: https://roji.dev.localhost).

Endpoints#

Health Check#

curl -s https://roji.dev.localhost/_api/health

{"status": "healthy", "routes": 5}

Status values:

Log Export#

Export request logs with optional filters:

# JSON format
curl -s "https://roji.dev.localhost/_api/logs/export?format=json"

# CSV format with filters
curl -s "https://roji.dev.localhost/_api/logs/export?format=csv&service=myapp&method=GET"

Query parameters:

SSE Streams#

Route Events (/_api/events)#

Sends events when routes are added, updated, or removed:

const es = new EventSource("https://roji.dev.localhost/_api/events");
es.onmessage = (event) => {
  const routes = JSON.parse(event.data);
  console.log("Routes updated:", routes);
};

Log Events (/_api/logs/events)#

Streams request log entries in real-time:

const es = new EventSource("https://roji.dev.localhost/_api/logs/events");
es.onmessage = (event) => {
  const log = JSON.parse(event.data);
  console.log(`${log.method} ${log.url} -> ${log.status}`);
};

CORS#

API endpoints support cross-origin requests from any *.dev.localhost subdomain, allowing API calls from services proxied through roji.