Referencia de la API

Introduction

The Nova Uptime API gives you programmatic access to manage your uptime monitors, run email health checks, and retrieve incident history. All endpoints return JSON and follow RESTful conventions.

{
  "success": true,
  "data": { ... },
  "message": "Optional status message"
}

"pagination": {
  "total": 42,
  "page": 1,
  "limit": 10,
  "totalPages": 5
}

Authentication

All API requests require authentication via an API key. Pass your key in theX-API-Keyheader with every request.

curl https://api.novauptime.com/api/v1/domains \
  -H "X-API-Key: YOUR_API_KEY"

Rate Limits

The API enforces per-user rate limits based on your plan. If you exceed the limit, you'll receive a 429 Too Many Requests response. Rate limit headers are included in every response:

• X-RateLimit-Limit — your plan's maximum requests per window
• X-RateLimit-Remaining — requests remaining in the current window
• X-RateLimit-Reset — Unix timestamp when the window resets

Plan Limits

Resource limits depend on your subscription plan. When a limit is reached, create/add endpoints will return a 400 error with a descriptive message.

{
  "success": false,
  "message": "Maximum domain limit (100) reached. Upgrade your plan to add more domains."
}

Error Codes

The API uses standard HTTP status codes. Errors include a descriptive message in the response body.

{
  "success": false,
  "message": "Human-readable error description"
}