Eén header om te authenticeren, REST en JSON voor alles wat ook in het portaal kan.
Schuivend venster, in elk pakket
Servers, back-ups, firewall en meer
Geversioneerd in de URL
Inbegrepen, niets te activeren
Geen OAuth-dans en geen token om te vernieuwen. Maak een API-sleutel aan in je
accountinstellingen, stuur hem mee in de header X-Virtbase-API-Key, en elk
endpoint staat open.
Sleutels verlopen niet. Ze worden precies één keer getoond, dus bewaar hem meteen – en verwijder hem zodra je hem niet meer nodig hebt.
curl https://virtbase.com/api/v1/servers \
-H "X-Virtbase-API-Key: $VIRTBASE_API_KEY"Alles wat een collectie teruggeeft, pagineert en sorteert hetzelfde. page en
per_page bepalen het venster, sort neemt een veld met optioneel :asc of
:desc, en meerdere velden zijn te combineren.
De envelop heeft altijd dezelfde vorm, dus een client die tegen de ene collectie werkt, werkt ook tegen de volgende.
{
"ssh_keys": [],
"meta": {
"pagination": {
"page": 1,
"per_page": 10,
"previous_page": null,
"next_page": 2,
"last_page": 10,
"total_entries": 100
}
}
}De standaard is 120 verzoeken per minuut – twee per seconde – over een schuivend venster, dus korte pieken zijn prima zolang het venster het houdt.
Elk antwoord draagt de actuele stand in de headers, dus een nette client hoeft
nooit te gokken. Ga je eroverheen, dan krijg je een 429 en niet stilletjes
niets.
Meer nodig? Vraag het support. Hogere limieten worden op verzoek toegekend, niet als duurder pakket verkocht.
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1787769600De API dekt hetzelfde terrein als het klantenportaal: servers, back-ups, firewallregels, reverse DNS, SSH-sleutels, ISO-images, aanbiedingen en facturen.
Daarmee is het hele leven van een machine scriptbaar. Een server aanmaken, wachten tot hij klaarstaat, een SSH-sleutel plaatsen, firewallregels schrijven, de reverse DNS op de adressen zetten, vóór een riskante deploy een back-up maken en die daarna terugzetten – zonder dat er ergens een browser aan te pas komt.
Het betekent ook dat de dingen die normaal blijven liggen scriptbaar worden. Reverse DNS voor een mailserver, een firewallregel die je kantoor-IP volgt, een nachtelijke back-up vóór je eigen migratie: het hoort in hetzelfde script als de rest van je infrastructuur.
Ga naar accountinstellingen in het klantenportaal en kies API in de navigatie.
Klik op API-sleutel aanmaken, geef hem een naam die je later herkent, en bevestig.
De sleutel wordt één keer getoond. Zet hem direct in je secret store of je CI-omgeving – later is hij niet meer uit te lezen.
De volledige referentie, met elke parameter en elk antwoord, staat op virtbase.com/api/docs. Die is alleen in het Engels beschikbaar.
1 vCore
4 GB RAM
50 GB NVMe SSD
1 IPv4 + IPv6/64-subnet
SkyLink Data Center, NL
2 vCores
8 GB RAM
100 GB NVMe SSD
1 IPv4 + IPv6/64-subnet
SkyLink Data Center, NL
4 vCores
16 GB RAM
150 GB NVMe SSD
1 IPv4 + IPv6/64-subnet
SkyLink Data Center, NL
4 vCores
24 GB RAM
170 GB NVMe SSD
1 IPv4 + IPv6/64-subnet
SkyLink Data Center, NL
6 vCores
36 GB RAM
200 GB NVMe SSD
1 IPv4 + IPv6/64-subnet
SkyLink Data Center, NL
8 vCores
48 GB RAM
250 GB NVMe SSD
1 IPv4 + IPv6/64-subnet
SkyLink Data Center, NL
10 vCores
56 GB RAM
270 GB NVMe SSD
1 IPv4 + IPv6/64-subnet
SkyLink Data Center, NL
12 vCores
64 GB RAM
300 GB NVMe SSD
1 IPv4 + IPv6/64-subnet
SkyLink Data Center, NL