API Documentation

Frag den aktuellen Status, einzelne Components oder offene Incidents von miniborlink.com ab. Alle Endpoints sind oeffentlich, kein Token noetig - einfach curl oder fetch drauf.

Base URL

https://api.miniborlink.com

Antwortformat: JSON (application/vnd.api+json).

Antworten

CodeBedeutung
200OK
404Resource nicht gefunden (z.B. unbekannte Metric-ID)
502Backend (Cachet) gerade nicht erreichbar

GET /api/status

Aggregierter System-Status in einem Satz.

curl https://api.miniborlink.com/api/status

Response 200

{
  "data": {
    "status": "operational",
    "message": "All Systems Operational"
  }
}

Moegliche status-Werte

WertBedeutung
operationalalles laeuft
performance_issuesspuerbar langsamer / instabil
partial_outageTeil-Ausfall
major_outagekompletter Ausfall
under_maintenanceWartung laeuft

GET /api/components

Listet alle Komponenten (Web, API, DNS, ...) mit ihrem aktuellen Status.

Query-Parameter

ParamTypDefaultBeschreibung
sortstring-name, order, id - mit - fuer DESC
includestring-group, incidents (komma-separiert)
per_pageinteger15Items pro Seite
pageinteger1Seitennummer
filter[status]1..6-Filter nach Status-Enum
filter[name]string-Filter nach Name
filter[enabled]boolean-Filter nach enabled
curl 'https://api.miniborlink.com/api/components?per_page=50&include=group'

Response 200 (gekuerzt)

{
  "data": [
    {
      "id": "1",
      "type": "components",
      "attributes": {
        "id": 1,
        "name": "Main Web",
        "description": "...",
        "status": { "human": "Operational", "value": "operational" },
        "enabled": true
      },
      "relationships": {
        "group": { "data": { "type": "componentGroups", "id": "1" } }
      }
    }
  ],
  "links": { "first": "...", "last": "...", "prev": null, "next": null },
  "meta":  { "current_page": 1, "from": 1, "to": 4, "per_page": 15 },
  "included": [ /* ComponentGroups falls include=group */ ]
}

GET /api/incidents

Liste der Incidents, neueste zuerst. Per Default werden alle (auch abgeschlossene) zurueckgegeben.

Query-Parameter

ParamTypDefaultBeschreibung
sortstring-name, status, id (mit - fuer DESC)
includestring-components, updates, user
per_pageinteger15Items pro Seite
pageinteger1Seitennummer
filter[status]string-Filter nach Status
filter[name]string-Filter nach Name
curl 'https://api.miniborlink.com/api/incidents?per_page=15&include=components,updates'

GET /api/metrics/{metric}/points/{metricPoint}

Holt einen einzelnen Metric Point (z.B. fuer eigene Auswertungen / Graphen).

Path-Parameter

ParamTypBeschreibung
metricintegerID der Metric
metricPointintegerID des Metric Points
curl https://api.miniborlink.com/api/metrics/1/points/42

Response 200 (gekuerzt)

{
  "data": {
    "id": "42",
    "type": "metricPoints",
    "attributes": {
      "id": 42,
      "metric_id": 1,
      "value": 17,
      "calculated_value": "17",
      "counter": 1,
      "created": { "human": "1 minute ago", "string": "..." }
    }
  }
}