API-Dokumentation

VPS erstellen

Erstelle eine neue VPS-Instanz. Dieser Endpunkt erstellt eine Bestellung, belastet deine gespeicherte Zahlungsmethode und stellt den Server bereit. Verwende den Bestellstatus-Endpunkt, um den Fortschritt zu verfolgen.

Anfrage

POST /api/v1/vps/create

Erforderlicher Scope: vps:provision

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Parameter Erforderlich Beschreibung
hostsystem Ja Hostsystem-Kennung (z.B. de_epyc, de_ryzen)
os Ja Betriebssystem-Kennung (z.B. ubuntu-24.04)
cores Ja Anzahl der CPU-Kerne (>= 1)
mem Ja RAM in GB (z.B. 8)
disk Ja NVMe-Speicher in GB (z.B. 20)
ips Nein Anzahl der IPv4-Adressen (Standard: 1)
backupSlots Nein Anzahl der Backup-Slots (Standard: 2)
networkSpeed Nein Netzwerkgeschwindigkeit in Mbit/s (Standard: 1000)
storage Nein Zusätzlicher HDD-Speicher in GB
name Nein Anzeigename für den VPS

Antwort

{
  "data": {
    "orderId": "507f1f77bcf86cd799439011",
    "orderToken": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "hostsystem": "de_epyc",
    "os": "ubuntu-24.04",
    "cores": 4,
    "mem": 8,
    "disk": 80,
    "status": "completed",
    "paymentId": "tr_abc123"
  }
}

Antwortfelder

Feld Typ Beschreibung
orderId string Bestell-ID zur Nachverfolgung
orderToken string Bestell-Token (UUID) zur Nachverfolgung
hostsystem string Das verwendete Hostsystem
os string Das zu installierende Betriebssystem
cores number Bereitgestellte CPU-Kerne
mem number RAM in GB
disk number NVMe-Speicher in GB
status string completed, payment_pending oder payment_failed
paymentId string Mollie-Zahlungs-ID

Statuswerte

Status Beschreibung
completed Zahlung erfolgreich, VPS wird bereitgestellt
payment_pending Zahlung eingeleitet (z.B. SEPA-Lastschrift), warte auf Bestätigung
payment_failed Zahlung wurde abgelehnt oder ist fehlgeschlagen

Voraussetzungen

Stelle vor der Nutzung dieses Endpunkts sicher, dass:

  1. Dein Konto mindestens einen Checkout über das Web-Dashboard abgeschlossen hat (um ein Zahlungsmandat einzurichten)
  2. Du eine gültige Zahlungsmethode hinterlegt hast
  3. Dein Konto nicht gesperrt ist

Verwende den VPS-Preise-Endpunkt, um verfügbare Hostsysteme, Betriebssysteme und Komponentenpreise vor der Erstellung eines VPS zu prüfen.

Fehlerantworten

Status Code Beschreibung
400 MISSING_HOSTSYSTEM Das Feld hostsystem ist erforderlich
400 MISSING_OS Das Feld os ist erforderlich
400 INVALID_CORES Das Feld cores muss >= 1 sein
400 INVALID_MEM Das Feld mem muss >= 1 sein
400 INVALID_DISK Das Feld disk muss >= 1 sein
400 PRICING_UNAVAILABLE Preis für VPS-Bestellung konnte nicht berechnet werden
403 account_suspended Konto ist gesperrt
403 no_valid_mandate Keine gültige Zahlungsmethode hinterlegt
403 no_billing_address Rechnungsadresse fehlt
403 INSUFFICIENT_SCOPE API-Schlüssel hat nicht den erforderlichen vps:provision-Scope
409 DUPLICATE_ORDER Eine identische Bestellung ist bereits ausstehend

Beispiel

# Einfachen VPS erstellen
curl -X POST https://hosting.site.quest/api/v1/vps/create \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{
    "hostsystem": "de_epyc",
    "os": "ubuntu-24.04",
    "cores": 4,
    "mem": 8,
    "disk": 80
  }'

# VPS mit allen Optionen erstellen
curl -X POST https://hosting.site.quest/api/v1/vps/create \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{
    "hostsystem": "de_epyc",
    "os": "ubuntu-24.04",
    "cores": 8,
    "mem": 16,
    "disk": 160,
    "ips": 2,
    "backupSlots": 4,
    "networkSpeed": 2000,
    "name": "Produktions-Server"
  }'

MCP

Diese Aktion ist auch über das create_vm MCP-Tool verfügbar.