Un en-tête pour s'authentifier, REST et JSON pour tout ce que fait l'espace client.
Fenêtre glissante, sur toutes les formules
Serveurs, sauvegardes, pare-feu et plus
Versionnée dans l'URL
Incluse, rien à activer
Pas de danse OAuth, pas de jeton à rafraîchir. Créez une clé d'API dans vos
paramètres de compte, envoyez-la dans l'en-tête X-Virtbase-API-Key, et tous
les points de terminaison vous sont ouverts.
Les clés n'expirent pas. Elles ne s'affichent qu'une seule fois : conservez-la dès sa création, et supprimez-la dès qu'elle ne sert plus.
curl https://virtbase.com/api/v1/servers \
-H "X-Virtbase-API-Key: $VIRTBASE_API_KEY"Tout ce qui renvoie une collection se pagine et se trie de la même façon. page
et per_page contrôlent la fenêtre, sort prend un champ suivi éventuellement
de :asc ou :desc, et plusieurs champs se combinent.
L'enveloppe garde toujours la même forme : un client écrit pour une collection fonctionne sur la suivante.
{
"ssh_keys": [],
"meta": {
"pagination": {
"page": 1,
"per_page": 10,
"previous_page": null,
"next_page": 2,
"last_page": 10,
"total_entries": 100
}
}
}Par défaut, 120 requêtes par minute – deux par seconde – sur une fenêtre glissante : les courtes rafales passent tant que la fenêtre tient.
Chaque réponse porte l'état courant dans ses en-têtes, un client correct n'a
donc jamais à deviner. Au-delà, vous recevez un 429, pas un abandon
silencieux.
Besoin de plus ? Demandez au support. Les limites supérieures s'accordent sur demande, elles ne se vendent pas.
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1787769600L'API couvre le même terrain que l'espace client : serveurs, sauvegardes, règles de pare-feu, DNS inverse, clés SSH, images ISO, offres et factures.
Toute la vie d'une machine devient donc scriptable. Créer un serveur, attendre sa mise à disposition, y pousser une clé SSH, écrire des règles de pare-feu, définir le DNS inverse de ses adresses, prendre une sauvegarde avant un déploiement risqué et la restaurer ensuite – sans navigateur nulle part.
Cela rend aussi scriptables les tâches qu'on oublie d'habitude : le DNS inverse d'un serveur de messagerie, une règle de pare-feu qui suit l'IP du bureau, une sauvegarde nocturne avant votre propre migration. Tout cela a sa place dans le même script que le reste de votre infrastructure.
Rendez-vous dans les paramètres de compte de l'espace client et choisissez API dans la navigation.
Cliquez sur Créer une clé d'API, donnez-lui un nom que vous reconnaîtrez plus tard, et confirmez.
La clé ne s'affiche qu'une fois. Mettez-la immédiatement dans votre coffre à secrets ou votre environnement d'intégration continue – elle ne sera plus lisible ensuite.
La référence complète, avec chaque paramètre et chaque forme de réponse, se trouve sur virtbase.com/api/docs. Elle n'existe qu'en anglais.
1 vCore
4Go RAM
50Go NVMe SSD
1 sous-réseau IPv4 + IPv6 /64
SkyLink Data Center, NL
2 vCores
8Go RAM
100Go NVMe SSD
1 sous-réseau IPv4 + IPv6 /64
SkyLink Data Center, NL
4 vCores
16Go RAM
150Go NVMe SSD
1 sous-réseau IPv4 + IPv6 /64
SkyLink Data Center, NL
4 vCores
24Go RAM
170Go NVMe SSD
1 sous-réseau IPv4 + IPv6 /64
SkyLink Data Center, NL
6 vCores
36Go RAM
200Go NVMe SSD
1 sous-réseau IPv4 + IPv6 /64
SkyLink Data Center, NL
8 vCores
48Go RAM
250Go NVMe SSD
1 sous-réseau IPv4 + IPv6 /64
SkyLink Data Center, NL
10 vCores
56Go RAM
270Go NVMe SSD
1 sous-réseau IPv4 + IPv6 /64
SkyLink Data Center, NL
12 vCores
64Go RAM
300Go NVMe SSD
1 sous-réseau IPv4 + IPv6 /64
SkyLink Data Center, NL