API Endpoints (Java API Gateway)

Authentication

POST /api/auth/login

Authenticate and receive a JWT bearer token.

Request:

{
  "username": "admin",
  "password": "admin123"
}

Response (200):

{
  "tokenType": "Bearer",
  "accessToken": "eyJhbGciOiJIUzI1NiJ9...",
  "expiresIn": 3600,
  "timestamp": 1710000000000
}

Errors: - 401: Invalid username or password

Traffic Prediction

GET /api/traffic/action

Demo endpoint - Picks a random junction and generates dummy observations. Requires JWT authentication.

Headers:

Authorization: Bearer <your_token>

Response (200):

{
  "junctionId": "300839359",
  "predictedAction": 1,
  "signalState": "YELLOW",
  "timestamp": 1710000000000,
  "status": "success"
}

Response (Fallback - Inference Down):

{
  "junctionId": "300839359",
  "predictedAction": 0,
  "signalState": "RED",
  "timestamp": 1710000000000,
  "status": "fallback_mode (inference service down)"
}

POST /api/traffic/action

Production endpoint - Accepts junction ID and custom observation vector. Requires JWT authentication.

Headers:

Authorization: Bearer <your_token>
Content-Type: application/json

Request:

{
  "junctionId": "joinedS_265580996_300839357",
  "observations": [0.0, 1.0, 0.0, 0.0, 0.0, 1.0, 0.0, 1.0, 0.12, 0.08, 0.33, 0.41, 0.22, 0.55, 0.18, 0.62, 0.70, 0.81, 0.50],
  "metadata": "morning-peak"
}

Response (200): Same structure as demo endpoint

Errors: - 400: Missing or invalid junctionId / observations - 400: Observations exceed maximum size (19) - 401: Missing or invalid JWT token - 500: Unexpected internal error

State Management

POST /api/traffic/reset

Reset GRU hidden states for all junctions (call at start of simulation run). Requires JWT authentication.

Headers:

Authorization: Bearer <your_token>

Response (200):

{
  "status": "ok",
  "message": "Hidden states reset for all junctions"
}

Health & Monitoring

GET /api/traffic/health

Service health check - Verifies inference service availability. No authentication required.

Response (200 - Healthy):

{
  "status": "healthy",
  "inferenceService": "up",
  "timestamp": 1710000000000
}

Response (503 - Degraded):

{
  "status": "degraded",
  "inferenceService": "down",
  "timestamp": 1710000000000
}