KLANT-API · V1 BÈTA
REST API voor
VPS & dedicated servers
Beheer uw servers vanuit code: bestel en verwijder uur-VPS'en, voer power-acties en herinstallaties uit, maak eigen images en rol ze uit, en betaal facturen met tegoed.
De Klant-API van X-ZoneServers (v1, publieke bèta) biedt 92 operaties via HTTPS, met een OpenAPI 3.0-specificatie, API-sleutels met scopes en een standaardlimiet van 1.000 verzoeken per uur per sleutel. De API is bij elk account inbegrepen zonder extra kosten.
92 API-operaties1.000 verzoeken per uur per sleutel
Uw eerste aanroep
Maak een sleutel aan in het klantgedeelte onder Profile → API Keys en vraag de API vervolgens wie u bent.
curl https://my.x-zoneservers.com/api/v1/ \
-H "Authorization: Bearer $XZ_API_KEY"
{ "success": true,
"data": {
"version": "1",
"key": { "scopes": ["read", "services"] },
"rate_limit": { "limit": 1000, "remaining": 999 }
} }01Functies
Wat u kunt automatiseren
De API dekt de volledige levenscyclus van een server, van bestelling tot factuur, met dezelfde rechten als het klantgedeelte.
Uitrollen & verwijderen
Bestel een VPS met facturering per uur of per maand, geef cloud-init user-data en SSH-keys mee voor de eerste boot en verwijder hem zodra de job klaar is. De facturering per uur stopt op het moment dat de server weg is.
Power, herinstallatie & statistieken
Start, stop, herstart en herinstalleer uw VPS, reset rootwachtwoorden en lees gebruiks- en verkeersstatistieken uit vanuit uw monitoringscripts.
Eigen images
Leg een VPS vast als image (maximaal 3 per account), of registreer uw eigen qcow2- of raw-image (geverifieerd via SHA-256) en rol er nieuwe servers mee uit.
Facturering & gebruik
Lees uw tegoed en de uurkosten van deze maand uit, vraag facturen en proformafacturen op en betaal ze met tegoed — handig voor kostendashboards en budgetwaarschuwingen.
Add-ons & upgrades
Koop add-ons voor een bestaande dienst, zoals extra IP-adressen, of zet hem over naar een groter plan zonder het klantgedeelte te openen.
Projecten & sleutels met scopes
Groepeer servers in projecten en maak sleutels aan die aan één project gebonden zijn, zodat een stagingsleutel nooit productie kan zien of aanraken.
02Zo werkt het
Voorbeeld: een uur-VPS voor één CI-job
Maak een schone buildmachine aan, draai de pipeline, verwijder hem — en betaal voor de uren dat hij bestond.
Uurdiensten worden van uw accounttegoed afgeschreven in plaats van gefactureerd, dus houd saldo op het account aan. Stuur bij elke bestelling een Idempotency-Key-header mee: een verzoek dat een time-out kreeg, kan dan opnieuw worden verstuurd zonder dat er een tweede server wordt aangemaakt.
1. Kies een plan: vraag de producten op met hun uur- en maandprijzen.
curl https://my.x-zoneservers.com/api/v1/products \
-H "Authorization: Bearer $XZ_API_KEY"2. Bestel het plan met facturering per uur, met een script voor de eerste boot en uw SSH-key.
curl -X POST https://my.x-zoneservers.com/api/v1/orders \
-H "Authorization: Bearer $XZ_API_KEY" \
-H "Idempotency-Key: ci-run-4812" \
-H "Content-Type: application/json" \
-d '{"productId": "<plan-id>", "billingCycle": "hourly",
"hostname": "ci-4812.example.com", "location": "<location>",
"configOptions": {"os_image_id": "<image-id>",
"ssh_keys": ["ssh-ed25519 AAAA... ci@runner"],
"user_data": "#!/bin/sh\n/opt/ci/run-pipeline.sh"}}'3. Is de job klaar, verwijder dan de server. De facturering stopt direct.
curl -X DELETE https://my.x-zoneservers.com/api/v1/vps/<vps-id> \
-H "Authorization: Bearer $XZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"immediate": true}'03API
Gebouwd voor scripts en AI-agents
Wanneer een programma en niet een mens op de knoppen drukt, telt voorspelbaar gedrag zwaarder dan het aantal endpoints.
Sleutels met scopes
Elke sleutel krijgt alleen de scopes die u toekent — read, services, orders, billing, destructive — plus een optionele IP-allowlist en vervaldatum.
Gepubliceerde rate limits
Standaard 1.000 verzoeken per uur per sleutel, gerapporteerd in X-RateLimit-headers, met korte cooldowns per server voor power- en herinstallatieacties.
Veilig opnieuw proberen
Bestellingen accepteren een Idempotency-Key en elke weigering geeft een machineleesbare foutcode terug, zodat automatisering een fout waarbij opnieuw proberen zin heeft kan onderscheiden van een echte fout.
Machineleesbare documentatie
Een OpenAPI 3.0-specificatie voor clientgenerators en een handleiding in platte Markdown die codeerassistenten en AI-agents rechtstreeks kunnen lezen.
04Gerelateerd
Verkoopt u servers aan uw eigen klanten?
Deze Klant-API automatiseert uw eigen account. Wilt u onder uw eigen merk doorverkopen, word dan lid van het resellerprogramma en gebruik in plaats daarvan de Reseller-API: groothandelsprijzen met volumestaffels, met HMAC ondertekende verzoeken, webhooks, aan klanten gebonden sleutels en consolelinks die uw klanten openen zonder account bij ons.
05Vragen
API-FAQ
Veelgestelde vragen over het automatiseren van X-ZoneServers.
Heeft X-ZoneServers een API?
Ja. De Klant-API (v1) is een REST API via HTTPS op https://my.x-zoneservers.com/api/v1 met 92 operaties voor VPS, dedicated servers, bestellingen, add-ons, upgrades, facturen, SSH-keys en eigen images. De API is in publieke bèta: stabiel genoeg om op te bouwen, maar endpoints en de opbouw van responses kunnen nog veranderen.
Is API-toegang gratis?
Ja. API-toegang is bij elk account inbegrepen zonder extra kosten; u betaalt alleen voor de servers en add-ons die u bestelt, tegen dezelfde prijzen als op de website en in het klantgedeelte.
Kan ik uur-VPS'en aanmaken en verwijderen via de API?
Ja. Plaats een bestelling met de factureringscyclus ingesteld op per uur, eventueel met cloud-init user-data en SSH-keys, en verwijder de VPS zodra u hem niet meer nodig heeft. Uurdiensten worden van het accounttegoed afgeschreven en worden niet meer gefactureerd zodra ze verwijderd zijn.
Werkt de API met dedicated servers?
Gedeeltelijk. Voor dedicated servers dekt de API bestellen, add-ons, facturen en dienstgegevens. Power-beheer, herinstallaties van het OS en wachtwoordresets zijn voor dedicated servers niet beschikbaar via de API of het klantgedeelte.
Hoe authenticeer ik mij?
Maak een API-sleutel aan in het klantgedeelte onder Profile → API Keys en stuur hem mee als Bearer-token. Kies de scopes bij het aanmaken en beperk de sleutel desgewenst tot specifieke IP-adressen of geef hem een vervaldatum. Sleutels worden maar één keer getoond en kunnen op elk moment in het klantgedeelte worden ingetrokken.
Is er een OpenAPI- of Swagger-specificatie?
Ja. De volledige OpenAPI 3.0-specificatie is gepubliceerd op https://my.x-zoneservers.com/api/v1/openapi.json, naast de gerenderde documentatie en een gebruikshandleiding in Markdown.
Aan de slag
Maak uw eerste API-sleutel aan
Log in op het klantgedeelte, open Profile → API Keys en doe uw eerste aanroep in minder dan een minuut. Vragen over de API gaan rechtstreeks naar de mensen die het platform bouwen.