Ein Header zur Authentifizierung, REST und JSON für alles, was auch im Portal geht.
Gleitendes Fenster, in jedem Paket
Server, Backups, Firewall und mehr
Versioniert in der URL
Enthalten, nichts zu aktivieren
Kein OAuth-Tanz, kein Token zum Erneuern. API-Key in den Kontoeinstellungen
anlegen, im Header X-Virtbase-API-Key mitschicken – fertig.
Keys laufen nicht ab. Sie werden genau einmal angezeigt, also gleich beim Anlegen sichern – und löschen, sobald sie nicht mehr gebraucht werden.
curl https://virtbase.com/api/v1/servers \
-H "X-Virtbase-API-Key: $VIRTBASE_API_KEY"Alles, was eine Sammlung zurückgibt, paginiert und sortiert gleich. page und
per_page steuern das Fenster, sort nimmt ein Feld mit optionalem :asc oder
:desc, mehrere Felder lassen sich kombinieren.
Der Umschlag hat immer dieselbe Form, ein Client gegen eine Sammlung funktioniert also auch gegen die nächste.
{
"ssh_keys": [],
"meta": {
"pagination": {
"page": 1,
"per_page": 10,
"previous_page": null,
"next_page": 2,
"last_page": 10,
"total_entries": 100
}
}
}Standard sind 120 Anfragen pro Minute – zwei pro Sekunde – über ein gleitendes Fenster. Kurze Bursts sind also in Ordnung, solange das Fenster hält.
Jede Antwort trägt den aktuellen Stand in den Headern, ein sauberer Client muss
also nie raten. Wer drüber ist, bekommt einen 429 und keinen stillen Verlust.
Mehr nötig? Support fragen. Höhere Limits gibt es auf Anfrage, nicht als Tarif-Upgrade.
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1787769600Die API deckt dasselbe Gebiet ab wie das Kundenportal: Server, Backups, Firewall-Regeln, Reverse DNS, SSH-Keys, ISO-Images, Angebote und Rechnungen.
Damit ist das ganze Leben einer Maschine skriptbar. Server anlegen, auf die Bereitstellung warten, SSH-Key einspielen, Firewall-Regeln schreiben, Reverse DNS auf den Adressen setzen, vor einem riskanten Deploy ein Backup ziehen und danach zurückspielen – ohne Browser irgendwo dazwischen.
Und damit werden auch die Dinge skriptbar, die sonst liegen bleiben: Reverse DNS für einen Mailserver, eine Firewall-Regel, die der Büro-IP folgt, ein nächtliches Backup vor der eigenen Migration. Alles gehört in dasselbe Skript wie der Rest der Infrastruktur.
In den Kontoeinstellungen im Kundenportal API in der Navigation wählen.
Auf API-Key erstellen klicken, einen Namen vergeben, den du später wiedererkennst, und bestätigen.
Der Key wird genau einmal angezeigt. Direkt in den Secret Store oder die CI-Umgebung übernehmen – später lässt er sich nicht mehr auslesen.
Die vollständige Referenz mit jedem Parameter und jeder Antwortform steht unter virtbase.com/api/docs. Sie ist nur auf Englisch verfügbar.
1 vCore
4 GB RAM
50 GB NVMe SSD
1 IPv4 + IPv6 /64 Subnetz
SkyLink Data Center, NL
2 vCores
8 GB RAM
100 GB NVMe SSD
1 IPv4 + IPv6 /64 Subnetz
SkyLink Data Center, NL
4 vCores
16 GB RAM
150 GB NVMe SSD
1 IPv4 + IPv6 /64 Subnetz
SkyLink Data Center, NL
4 vCores
24 GB RAM
170 GB NVMe SSD
1 IPv4 + IPv6 /64 Subnetz
SkyLink Data Center, NL
6 vCores
36 GB RAM
200 GB NVMe SSD
1 IPv4 + IPv6 /64 Subnetz
SkyLink Data Center, NL
8 vCores
48 GB RAM
250 GB NVMe SSD
1 IPv4 + IPv6 /64 Subnetz
SkyLink Data Center, NL
10 vCores
56 GB RAM
270 GB NVMe SSD
1 IPv4 + IPv6 /64 Subnetz
SkyLink Data Center, NL
12 vCores
64 GB RAM
300 GB NVMe SSD
1 IPv4 + IPv6 /64 Subnetz
SkyLink Data Center, NL