Management API

Health Check

Check if your service is running:

curl https://localhost:8443/health

Response:

{
  "status": "healthy",
  "uptime": "2h 15m 30s",
  "version": "1.0.0"
}

Service Statistics

Get usage statistics:

curl https://localhost:8443/admin/stats

Response:

{
  "requests": {
    "total": 1247,
    "successful": 1198,
    "failed": 49,
    "averageResponseTime": "145ms"
  },
  "uptime": "2h 15m 30s",
  "version": "1.0.0"
}

Recent Verifications

See recent verification requests:

curl https://localhost:8443/admin/verifications?limit=10

Response:

{
  "verifications": [
    {
      "id": "ver-123456789",
      "name": "John Smith",
      "iban": "DE89370400440532013000",
      "result": "MATCH",
      "timestamp": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 1247
}

Common Management Tasks

🔍 Monitor Service Health

# Quick health check
curl https://localhost:8443/health

# Detailed system status
curl https://localhost:8443/health/detailed

📊 View Usage Statistics

# Overall statistics
curl https://localhost:8443/admin/stats

# Today's statistics
curl https://localhost:8443/admin/stats?period=today

📋 Review Recent Activity

# Last 50 verifications
curl https://localhost:8443/admin/verifications

# Failed verifications only
curl https://localhost:8443/admin/verifications?status=failed

🔧 Administrative Tasks

# Reset test data (development only)
curl -X POST https://localhost:8443/admin/reset-test-data

# Import fresh test cases
curl -X POST https://localhost:8443/admin/import-test-data

Web Interface

For easier management, visit:

• 📊 Dashboard: https://localhost:8443/admin
• 📈 Statistics: https://localhost:8443/admin/stats
• 🧪 Test Interface: https://localhost:8443/test

Security

🔒 Access Control

• Management endpoints require admin certificates
• All operations are audit logged
• Rate limited to prevent abuse

📝 Audit Trail

Every management operation is logged:

{
  "timestamp": "2024-01-15T10:30:00Z",
  "operation": "view_statistics",
  "user": "admin",
  "result": "success"
}

Error Responses

Access Denied

{
  "error": "ACCESS_DENIED",
  "message": "Admin privileges required"
}

Service Unavailable

{
  "error": "SERVICE_UNAVAILABLE",
  "message": "Service temporarily unavailable",
  "retry_after": 30
}