De OMC Cloud API is RESTful en werkt met elke HTTP-client in elke taal. Authenticeer met je client-ID en secret en roep daarna elk endpoint aan.
https://console.omc.cloud/serviceGenereer je API-gegevens in je OMC Cloud-dashboard onder Settings → API Keys. Je ontvangt een clientId en secret.
Je kunt verzoeken op twee manieren authenticeren:
curl https://console.omc.cloud/service/servers
-H "Content-Type: application/json"
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"Wissel eerst je gegevens in voor een token van 1 uur:
curl -X POST https://console.omc.cloud/service/authenticate
-H "Content-Type: application/json"
-d '{"clientId":"YOUR_CLIENT_ID","secret":"YOUR_SECRET"}'Antwoord:
{
"authentication": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"expires": 1745393200
}Gebruik het token daarna in volgende verzoeken:
curl https://console.omc.cloud/service/servers
-H "Content-Type: application/json"
-H "authorization: YOUR_TOKEN"/serversGeeft een array terug van alle servers in je account met hun ID, datacenter, naam en energiestatus.
curl https://console.omc.cloud/service/servers
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"import requests
url = "https://console.omc.cloud/service/servers"
headers = {
'Content-Type': 'application/json',
'clientId': 'YOUR_CLIENT_ID',
'secret': 'YOUR_SECRET',
}
response = requests.get(url, headers=headers)
print(response.json())/serverGeeft de volledige lijst terug van beschikbare datacenters, CPU-typen, RAM-groottes, schijfopties, OS-templates, verkeerspakketten, netwerken en factureringstypen die je kunt gebruiken bij het aanmaken van een nieuwe server.
curl https://console.omc.cloud/service/server
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"/serverRicht een nieuwe virtuele server in met de opgegeven configuratie. Geeft een taak-ID terug dat je kunt pollen tot de taak voltooid is.
disk_src_0 – ID van de OS-imagedatacenter – Locatiecodename – Servernaam (4-40 tekens, alfanumeriek + ./-/_)cpu – CPU-type en aantal (bijv. 1B, 2D)ram – Geheugen in MBpassword – 9-32 tekens, hoofd- en kleine letters + cijfersbilling – monthly of hourlytraffic – ID van het verkeerspakket (bijv. t5000)disk_size_0 – Schijfgrootte in GBnetwork_name_0 – Netwerknaam (gebruik wan voor een automatisch IP)managed – Managed services inschakelenbackup – Dagelijkse back-ups inschakelenpower – Automatisch opstarten na voltooiingselectedSSHKeyValue – Publieke SSH-sleutelnetwork_ip_0 – Specifiek IP (optioneel met WAN)curl -X POST https://console.omc.cloud/service/server
-H "Content-Type: application/json"
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"
-d '{
"disk_src_0": "IL:XXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"datacenter": "IL-TLV",
"name": "my-production-server",
"cpu": "2B",
"ram": "4096",
"password": "YourSecurePass123",
"network_name_0": "wan",
"billing": "monthly",
"traffic": "t5000",
"disk_size_0": "40"
}'/server/cloneDupliceert een bestaande server inclusief OS, software, configuratie en data. Geeft een taak-ID terug.
Verplicht: source (UUID), name, password, billing
curl -X POST https://console.omc.cloud/service/server/clone
-H "Content-Type: application/json"
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"
-d '{
"source": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "server-clone",
"password": "YourSecurePass123",
"billing": "monthly"
}'/server/{serverid}Geeft volledige informatie over een specifieke server: ID, datacenter, CPU, RAM, energiestatus, schijven, netwerken (met IP’s), factureringstype, verkeerspakket, managed-status en back-upstatus.
curl https://console.omc.cloud/service/server/SERVER_UUID
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"/server/{serverid}/terminateVerwijdert een server permanent. Deze actie kan niet ongedaan worden gemaakt. Verplichte body: confirm=1. Als de server aan staat, geef dan ook force=1 mee.
curl -X DELETE https://console.omc.cloud/service/server/SERVER_UUID/terminate
-H "Content-Type: application/x-www-form-urlencoded"
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"
-d 'confirm=1&force=1'/server/{serverid}/powerZet een server aan of uit, of herstart hem. Stuur power=on, power=off of power=restart als form data. Geeft een taak-ID terug.
curl -X PUT https://console.omc.cloud/service/server/SERVER_UUID/power
-H "Content-Type: application/x-www-form-urlencoded"
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"
-d 'power=on'/server/{serverid}/cpuGeeft de CPU-configuraties terug waarnaar de server kan worden geschaald (typen A, B, T, D met tot 104 vCPU’s).
/server/{serverid}/cpuWijzig de CPU van de server. Stuur cpu=2B als form data.
/server/{serverid}/ramGeeft de beschikbare RAM-groottes in MB per CPU-type terug.
/server/{serverid}/ramWijzig het RAM van de server. Stuur ram=4096 als form data (grootte in MB).
/server/{serverid}/diskGeeft de array terug van schijfgroottes in GB waarnaar je kunt schalen.
/server/{serverid}/diskWijzig de grootte van een bestaande harde schijf. Stuur JSON: {"size":"40","index":"0","provision":"1"}
curl -X PUT https://console.omc.cloud/service/server/SERVER_UUID/disk
-H "Content-Type: application/json"
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"
-d '{"size":"40","index":"0","provision":"1"}'/server/{serverid}/diskVoeg een extra harde schijf toe aan de server. Stuur size=20&provision=1 als form data.
/server/{serverid}/disk/removeVerwijder een schijf permanent. Stuur index=1&confirm=1 als form data. Gegevensverlies is permanent.
/server/{serverid}/snapshotsGeeft een array terug van alle snapshots van de server met ID, naam, datum, actieve status en diepte.
/server/{serverid}/snapshotMaak een snapshot van de server op een bepaald moment. Stuur name=my-snapshot.
/server/{serverid}/snapshotZet de server terug naar een eerdere snapshot. Stuur snapshotId=1745411375.
/server/{serverid}/snapshotVerwijder een snapshot. Stuur snapshotId=1745411375.
/server/{serverid}/renameWijzig de naam van de server. Stuur name=new-server-name. Beperkingen: 4-40 tekens, letters/cijfers/punten/streepjes/underscores.
/server/{serverid}/passwordWerk het rootwachtwoord van de server bij. Stuur password=NewSecurePass123. Beperkingen: 9-32 tekens, hoofd- en kleine letters + cijfers.
/server/{serverid}/billingGeeft de actieve en toekomstige factureringsmodus van de server terug.
/server/{serverid}/billingSchakel tussen facturering per maand en per uur. Stuur type=monthly&traffic=t5000.
/server/{serverid}/hdlibGeeft een array terug van schijfobjecten met UUID en grootte in GB die beschikbaar zijn om te klonen.
/server/{serverid}/hdlibMaak een nieuwe schijf aan vanuit een bron in de bibliotheek. Stuur disk_name_0=cloned-disk&disk_src_0=DISK_UUID.
De OMC Cloud API is gebaseerd op REST en werkt met elke HTTP-client. Voor het gemak kun je ook het volgende gebruiken:
requests-bibliotheekfetch, axios of node-fetchcURL of GuzzleDe API gebruikt standaard HTTP-statuscodes:
200 OK – Geslaagd verzoek400 Bad Request – Ongeldige parameters of onjuist opgebouwd verzoek401 Unauthorized – Ontbrekende of ongeldige gegevens403 Forbidden – Authenticatie geslaagd maar toestemming geweigerd404 Not Found – Resource bestaat niet500 Internal Server Error – Probleem aan de serverkant (neem contact op met support)De meeste geslaagde bewerkingen geven een taak-ID terug waarmee je de asynchrone voortgang kunt volgen. Alle verzoeken moeten via HTTPS worden verzonden.
Genereer je API-gegevens in het OMC Cloud-dashboard en begin binnen enkele minuten met automatiseren.
API-gegevens aanvragen →Sluit je aan bij de tienduizenden klanten die elke dag op OMC vertrouwen
Door je aan te melden ga je akkoord met de servicevoorwaarden
Ontvang binnen een halfuur een persoonlijke offerte
Door je aan te melden ga je akkoord met de servicevoorwaarden