health-api
Hardened HTTP/HTTPS telemetry engine built for reliable endpoint health probing, latency profiling, and historical state persistence with strict RFC 1918 private network isolation.
Interactive API Explorer
LIVE SIMULATIONSystem Architecture
CORE PILLARSGuards against internal network scanning by resolving hostnames pre-flight and rejecting RFC 1918 addresses (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, loopback 127.0.0.1, and link-local 169.254.169.254).
Normalized relational schema with foreign key constraints, connection pooling, and B-tree indexing on timestamps for zero-lag historical latency aggregation and SLA compliance calculations.
Multi-stage Docker builds running under dedicated unprivileged non-root users. Uses explicit health checks and internal bridge networks to prevent unauthorized host-level socket exposure.
Comprehensive integration and unit testing powered by Jest and Supertest. Every route, database query, and SSRF boundary is validated in automated GitHub Actions pipelines before merging.
Defense-in-Depth Implementation
SECURITY
Traditional URL monitors are prime targets for Server-Side Request Forgery (SSRF). health-api inspects resolved IP addresses before any socket connection is initiated:
API Reference
REST ENDPOINTS| Method | Endpoint | Description | Response |
|---|---|---|---|
| GET | /health |
Internal system and database health probe | 200 OK |
| GET | /api/targets |
List all registered monitoring targets | 200 OK |
| POST | /api/targets |
Register new URL (with pre-flight SSRF validation) | 201 Created |
| GET | /api/targets/:id/telemetry |
Retrieve latency stats, uptime percentage & logs | 200 OK |
Deployment & Quickstart
DOCKER COMPOSEClone the repository and spin up both the API service and PostgreSQL database in an isolated Docker network: