🔍 HTTP Keep-Alive Analyzer

Health Check

Check if the service is running and discover available endpoints. This endpoint does not analyze any domain - it's purely for service health monitoring and API discovery.

GET /api/health

No parameters required.

Example:

curl http://localhost:3000/api/health

Response:

{
  "status": "ok",
  "service": "HTTP Keep-Alive Analyzer",
  "version": "2.0",
  "endpoints": {
    "analyze_get": "/api/analyze?domain=example.com&useCachedDns=false",
    "analyze_post": "/api/analyze (POST with JSON body)",
    "health": "/api/health"
  }
}

Domain Analysis

These endpoints perform the actual domain analysis. A domain parameter is required for all analysis endpoints.

GET Method (Query Parameters)

GET /api/analyze?domain=example.com&useCachedDns=false

Parameters:

• domain (required): Domain to analyze
• useCachedDns (optional): Use system DNS cache (true/false)

Example:

curl "http://localhost:3000/api/analyze?domain=google.com&useCachedDns=false"

POST Method (JSON Body)

POST /api/analyze
Content-Type: application/json

{
  "domain": "example.com",
  "useCachedDns": false
}

Example:

curl -X POST http://localhost:3000/api/analyze \
  -H "Content-Type: application/json" \
  -d '{"domain":"google.com","useCachedDns":false}'

Response Format

Both GET and POST methods return comprehensive JSON with:

• DNS Records: CNAME and A records with TTL
• HTTP Headers: Response headers from each server
• Keep-Alive Settings: Timeout and connection info
• CDN Detection: CDN providers with confidence levels
• Server Fingerprinting: Server type, version, platform
• TCP Analysis: Connection details and quality metrics
• CSP Evaluation: Security policy analysis

Error Handling

API endpoints return structured error responses:

{
  "error": "Missing 'domain' parameter",
  "status": 400
}

Common Error Codes:

• 400: Bad Request (invalid domain, missing parameters)
• 405: Method Not Allowed
• 500: Internal Server Error (analysis failed)

CORS Support

All API endpoints include CORS headers for cross-origin requests.