API-Dokumentation

VPS abrufen

Gibt detaillierte Informationen über einen einzelnen VPS zurück, einschließlich Live-Status und Konfiguration vom Hosting-Provider.

Anfrage

GET /api/v1/vps/{id}

Erforderlicher Scope: vps:read

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "id": "699cdea2ab57a244bb5273fd",
    "name": "mein-server",
    "status": "RUNNING",
    "cores": 4,
    "mem": 8,
    "nvme": 20,
    "hdd": 0,
    "ips": 1,
    "backupSlots": 0,
    "networkSpeed": 1000,
    "os": "Ubuntu 22.04",
    "iso": null,
    "datacenter": "SkyLink Data Center BV",
    "country": "NL",
    "cpuUsage": 1.02,
    "memUsage": 42.31,
    "nvmeUsage": 0.44,
    "hddUsage": 0,
    "availability": 100,
    "ipv4": [
      {
        "address": "45.84.196.79",
        "gateway": "45.84.196.1",
        "rdns": "mein-server.site.quest"
      }
    ],
    "ipv6": [],
    "config": { ... },
    "liveStatus": { ... },
    "subscription": {
      "cancelledAt": null,
      "expiresAt": null,
      "interval": "1 month"
    },
    "createdAt": "2026-02-23T23:11:30.525Z"
  }
}

Antwortfelder

Feld Typ Beschreibung
id string Eindeutige Server-ID
name string Anzeigename des Servers
status string Aktueller Status
cores number Anzahl der CPU-Kerne
mem number RAM in GB
nvme number NVMe-Speicher in GB
hdd number HDD-Speicher in GB
ips number Anzahl der IP-Adressen
backupSlots number Anzahl der Backup-Slots
networkSpeed number Netzwerkgeschwindigkeit in Mbit/s
os string Betriebssystem
iso string | null Eingebundenes ISO-Image, falls vorhanden
datacenter string Rechenzentrum
country string Ländercode
cpuUsage number CPU-Auslastung in Prozent
memUsage number Speicherauslastung in Prozent
nvmeUsage number NVMe-Auslastung in Prozent
hddUsage number HDD-Auslastung in Prozent
availability number Verfügbarkeit in Prozent
ipv4 array IPv4-Adressen mit Gateway und rDNS
ipv6 array IPv6-Adressen
config object | null Live-Konfiguration vom Hosting-Provider
liveStatus object | null Live-Status vom Hosting-Provider
subscription object | null Abonnement-Status (siehe unten)
createdAt string ISO-8601-Erstellungszeitstempel

Abonnement-Felder

Feld Typ Beschreibung
cancelledAt string | null Wann das Abonnement gekündigt wurde (ISO 8601), oder null wenn aktiv
expiresAt string | null Wann das Abonnement abläuft (ISO 8601), oder null wenn es verlängert wird
interval string | null Abrechnungsintervall (z.B. "1 month", "12 months")

Sensible Felder wie password und username werden aus dem config-Objekt entfernt.

Fehler

Status Code Beschreibung
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff

Beispiel

curl https://hosting.site.quest/api/v1/vps/699cdea2ab57a244bb5273fd \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

MCP

Diese Daten sind auch über das get_vm MCP-Tool verfügbar.