API Enterno.io

Authentication

All API v3 requests require a key. Pass it via the X-API-Key header (recommended) or the api_key parameter. JSON body is also supported.

Get an API key by creating an account or in your dashboard.

curl -H "X-API-Key: YOUR_KEY" \
  "https://enterno.io/api/v3/check.php?url=example.com"

Every response includes an X-Request-Id header for tracing.

Response Format

API v3 uses a JSON:API-style envelope with metadata:

{
  "data": { ... },
  "meta": {
    "request_id": "a1b2c3d4e5f6a7b8c9d0e1f2",
    "duration_ms": 142,
    "cached": false,
    "api_version": "3.0"
  }
}

On error:

{
  "error": {
    "code": "invalid_url",
    "message": "URL is required"
  },
  "meta": {
    "request_id": "a1b2c3d4e5f6a7b8c9d0e1f2",
    "duration_ms": 2
  }
}

For paginated endpoints, meta includes a pagination object:

"pagination": {
  "total": 15,
  "page": 1,
  "per_page": 25,
  "pages": 1
}

Rate Limits

Rate limit information is included in response headers:

Scopes

Each API key has a set of permitted scopes. A request to an inaccessible endpoint will return a 403 error.

Check — HTTP Header Check

Get HTTP response headers with detailed timing breakdown (DNS, connect, TLS, TTFB).

Parameters

Example

curl -H "X-API-Key: YOUR_KEY" \
  "https://enterno.io/api/v3/check.php?url=https://example.com"

Response

{
  "data": {
    "url": "https://example.com",
    "final_url": "https://example.com/",
    "method": "GET",
    "code": 200,
    "http_version": "HTTP/2",
    "ip": "93.184.216.34",
    "headers": [...],
    "timing": {
      "dns_ms": 12,
      "connect_ms": 45,
      "tls_ms": 78,
      "ttfb_ms": 120,
      "transfer_ms": 142,
      "redirect_ms": 0,
      "redirect_count": 0
    },
    "elapsed_ms": 142
  },
  "meta": {"request_id": "...", "duration_ms": 150, "cached": false, "api_version": "3.0"}
}

DNS — DNS Lookup

Get DNS records with optional DNSSEC validation.

Parameters

Example

curl -H "X-API-Key: YOUR_KEY" \
  "https://enterno.io/api/v3/dns.php?domain=example.com&dnssec=1"

SSL — SSL/TLS Check

Check SSL certificate with detailed chain information.

Parameters

Example

curl -H "X-API-Key: YOUR_KEY" \
  "https://enterno.io/api/v3/ssl.php?host=example.com"

IP — Geolocation

Determine location, ISP and organization by IP address or domain.

Parameters

Example

curl -H "X-API-Key: YOUR_KEY" \
  "https://enterno.io/api/v3/ip.php?host=8.8.8.8"

Ping — Ping, Ports & Traceroute

Ping a host, check ports, or run a traceroute.

Parameters

Example

curl -H "X-API-Key: YOUR_KEY" \
  "https://enterno.io/api/v3/ping.php?host=example.com&action=traceroute"

Health — Website Health Score

Comprehensive website health analysis: security headers (30pts), SSL/TLS (25pts), performance (25pts), best practices (20pts). Returns a score 0-100 with grade A+ to F.

Parameters

Example

curl -H "X-API-Key: YOUR_KEY" \
  "https://enterno.io/api/v3/health.php?url=example.com"

Response

{
  "data": {
    "url": "https://example.com",
    "score": 82,
    "grade": "A",
    "categories": [
      {"name": "Security Headers", "score": 22, "max": 30, "checks": [...]},
      {"name": "SSL/TLS", "score": 25, "max": 25, "checks": [...]},
      {"name": "Performance", "score": 20, "max": 25, "checks": [...]},
      {"name": "Best Practices", "score": 15, "max": 20, "checks": [...]}
    ],
    "recommendations": [
      {"type": "critical", "check": "Permissions-Policy"},
      {"type": "warning", "check": "Server info hidden"}
    ]
  },
  "meta": {"request_id": "...", "duration_ms": 2400, "cached": false, "api_version": "3.0"}
}

Monitors — CRUD

Create, read, update and delete uptime monitors via API.

List monitors

Get single monitor

Returns monitor details with 20 most recent checks.

Create monitor

curl -X POST "https://enterno.io/api/v3/monitors.php" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "check_type": "http",
    "interval_minutes": 5,
    "expected_code": 200,
    "notify_email": true
  }'

Update monitor

curl -X PUT "https://enterno.io/api/v3/monitors.php?id=5" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"interval_minutes": 10, "is_active": false}'

Delete monitor

curl -X DELETE "https://enterno.io/api/v3/monitors.php?id=5" \
  -H "X-API-Key: YOUR_KEY"

Status — Public Status Page

Get status page data as JSON. No authentication required when slug is provided.

Example

curl "https://enterno.io/api/v3/status.php?slug=my-company"

Response

{
  "data": {
    "title": "My Company Status",
    "slug": "my-company",
    "overall_status": "operational",
    "monitors_total": 5,
    "monitors_down": 0,
    "monitors": [
      {"id": 1, "name": "example.com", "status": "up", "response_time_ms": 120}
    ],
    "recent_incidents": []
  },
  "meta": {"request_id": "...", "duration_ms": 15, "cached": false, "api_version": "3.0"}
}

Error Codes

Authentication

All API requests require a key. Pass it via the X-API-Key header (recommended) or the api_key parameter.

Get an API key by creating an account or in your dashboard.

curl -H "X-API-Key: YOUR_KEY" \
  https://enterno.io/api/check.php?url=example.com

Response Format

All responses follow a unified JSON format:

{
  "success": true,
  "data": { ... }
}

On error:

{
  "success": false,
  "error": "Error description"
}

Rate Limits

Scopes

Each API key has a set of permitted scopes. A request to an inaccessible endpoint will return a 403 error.

Endpoints

API v2 endpoints use /api/v2/*.php paths. All accept GET and POST.

Error Codes