api documentation

infrastructure API overview

The status information for rennhofer.cloud is exposed via a public, read-only JSON API. No credentials, tokens, or authentication headers are required to access these endpoints. All responses are returned with CORS headers enabled (Access-Control-Allow-Origin: *).

available endpoints

GET /api/status

Returns the full structure of the current infrastructure state, including overall status, service listing, planned maintenance details, and active or recent incidents.

example request:

curl -X GET https://status.rennhofer.cloud/api/status

example response:

{
  "status": "operational",
  "message": "All systems are operational.",
  "last_updated": "2026-08-11T17:30:00Z",
  "services": [
    {
      "id": "rennhofer-cloud",
      "name": "rennhofer.cloud",
      "status": "up",
      "planned_maintenance": null
    },
    {
      "id": "status-page",
      "name": "status.rennhofer.cloud",
      "status": "up",
      "planned_maintenance": null
    },
    {
      "id": "nextcloud",
      "name": "Nextcloud Storage",
      "status": "up",
      "planned_maintenance": null
    },
    {
      "id": "git",
      "name": "Git Services",
      "status": "up",
      "planned_maintenance": {
        "active": false,
        "start_time": "2026-08-15T02:00:00Z",
        "end_time": "2026-08-15T04:00:00Z",
        "details": "Scheduled database migration and system updates."
      }
    }
  ],
  "incidents": [
    {
      "id": "inc-101",
      "title": "Minor Database Degradation",
      "status": "resolved",
      "severity": "minor",
      "created_at": "2026-08-10T14:00:00Z",
      "resolved_at": "2026-08-10T15:30:00Z",
      "updates": [
        {
          "time": "2026-08-10T14:05:00Z",
          "text": "We are investigating reports of slow response times from the primary database cluster."
        },
        {
          "time": "2026-08-10T15:30:00Z",
          "text": "The issue has been resolved and database performance has returned to normal."
        }
      ]
    }
  ]
}