Bedieners-API

KRY /api/v1/servers/

Lys alle bedieners

Gee terug die bedieners in u rekening, nuutste eerste, 25 per bladsy. Bedieners wat word uitgevee word nie ingesluit nie.

Benodigde toestemming: servers:list

Navraagparameters

Parameter	Tipe	Vereis	Beskrywing
`page`	integer	Nee	Bladsy nommer, beginne na 1
`page_size`	integer	Nee	Resultate per bladsy (verstek 25, maksimum 100)

Voorbeeldversoek

cURL

Python

JavaScript

PHP

curl -X GET "https://admin.vps.org/api/v1/servers/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests

url = "https://admin.vps.org/api/v1/servers/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for server in response.json()["results"]:
    print(server["uuid"], server["hostname"], server["status"])

const response = await fetch('https://admin.vps.org/api/v1/servers/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
console.log(data.results);

$ch = curl_init('https://admin.vps.org/api/v1/servers/');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer YOUR_API_TOKEN']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

foreach ($data['results'] as $server) {
    echo $server['hostname'] . ' ' . $server['status'] . "\n";
}

Voorbeeldantwoord

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b",
      "hostname": "web-01",
      "status": "on",
      "error_description": null,
      "location_name": "New Jersey",
      "plan_name": "1 vCPU / 2 GB RAM / 10 GB",
      "os_name": "Ubuntu",
      "ipv4_addresses": ["203.0.113.10"],
      "ipv6_addresses": ["2001:db8:2:dd::f9:6b"],
      "created_at": "2026-07-30T03:54:14.914364Z",
      "deployed": true
    },
    {
      "uuid": "2d7e9b40-6c1a-4f3e-8b5d-9a0c1e2f3b4d",
      "hostname": "db-01",
      "status": "queue",
      "error_description": null,
      "location_name": "New Jersey",
      "os_name": "Debian",
      "ipv4_addresses": [],
      "ipv6_addresses": [],
      "created_at": "2026-09-14T19:33:49.426508Z",
      "deployed": false
    }
  ]
}

Antwoordvelde

Veld	Tipe	Beskrywing
`uuid`	string	Bedieneridentifiseerder wat in elke ander bediener-eipunt gebruik word
`hostname`	string	Gasheernaam jy het gekies wanneer die bediener geskep is
`status`	string	Huidige staat. Sien Bediener Status Waardes hieronder.
`error_description`	string \| null	Besonderhede van die laaste mislukking wanneer status is fout, andersins nuller
`location_name`	string	Naam van die ligging waarin die bediener loop
`os_name`	string	Operating stelsel naam, sonder die weergawe
`plan_name`	string	Leesbare plan opsomming, byvoorbeeld 1 vCPU / 2 GB Ram / 10 GB
`ipv4_addresses`	array	IPv4 adresse as stringe. Leeg totdat die bediener gebruik word, en op planne sonder IPv4.
`ipv6_addresses`	array	IPv6 adresse as stringe. Leeg totdat die bediener gesirkuleer is.
`created_at`	datetime	Skeppingstyd (Iso 8601, UTC)
`deployed`	boolean	Waar gemaak is nadat die verskaffing voltooi is

Reaksiestatuskodes

200	Bedienerlys suksesvol opgehaal
403	Ontbrekende of ongeldige API-bewys, of die teken het nie die nodige toestemming nie

AGT /api/v1/servers/

Skep Nuwe Bediener

Wagtou 'n nuwe bediener vir ontplooiing en gee dit dadelik terug met status wagtou. Indiening gaan voort in die agtergrond: Meningspunt van status en eindig totdat dit gesirkuleer is. Wanneer die bediener gereed is, word die aanteken details aan die rekeningeienaar ge-poseer.

Jou rekening het 'n gestoorde betaling metode nodig. Na gelang van jou rekening geskiedenis,' n tydelike pre-authorizasie hou van ongeveer een week van die planprys (ten minste 1 USD) mag dalk op jou kaart geplaas word voordat die bediener geskep word.

Benodigde toestemming: servers:create

Versoekliggaamparameters

Parameter	Tipe	Vereis	Beskrywing
`hostname`	string	Ja	Ten minste 3 karakters. Letters, syfers, hifens en periodes alleen.
`location_id`	integer	Ja	Die ID van 'n aktiewe ligging van die liggings API
`plan_uuid`	string	Ja	Die uuid van 'n aktiewe plan van die Plans API
`operating_system_version_uuid`	string	Ja	Die uUID van 'n aktiewe inskrywing in 'n bedryfstelsel se weergaweslys
`ssh_key_uuids`	array	Nee	UUID's van SSH-sleutels van die SSH-sleutels API om op die bediener te installeer
`ssh_key_ids`	array	Nee	Heelgetal idies van SSH-sleutels, as 'n alternatief vir ssh_key_uuids. Indien altwee gestuur word, word ssh_key_ids gebruik.
`ssh_key_uuid`, `ssh_key_id`	string, integer	Nee	Korthand vir 'n enkele SSH-sleutel
`auth_method`	string	Nee	wagwoord, ssh_key of beide. Verstek na wagwoord, of na beide wanneer SSH-sleutels verskaf word.

Voorbeeldversoek

cURL

Python

JavaScript

PHP

curl -X POST "https://admin.vps.org/api/v1/servers/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "hostname": "web-01",
    "location_id": 1,
    "plan_uuid": "3bc2faf6-8f8b-4978-b62d-b52ed3f858e9",
    "operating_system_version_uuid": "c3418f90-80a0-4e00-a7e1-d0ab1822b941",
    "ssh_key_uuids": ["YOUR_SSH_KEY_UUID"]
  }'

import requests

url = "https://admin.vps.org/api/v1/servers/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}
data = {
    "hostname": "web-01",
    "location_id": 1,
    "plan_uuid": "3bc2faf6-8f8b-4978-b62d-b52ed3f858e9",
    "operating_system_version_uuid": "c3418f90-80a0-4e00-a7e1-d0ab1822b941",
    "ssh_key_uuids": ["YOUR_SSH_KEY_UUID"],
}

response = requests.post(url, headers=headers, json=data)
server = response.json()
print(response.status_code, server["uuid"], server["status"])

const response = await fetch('https://admin.vps.org/api/v1/servers/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    hostname: 'web-01',
    location_id: 1,
    plan_uuid: '3bc2faf6-8f8b-4978-b62d-b52ed3f858e9',
    operating_system_version_uuid: 'c3418f90-80a0-4e00-a7e1-d0ab1822b941',
    ssh_key_uuids: ['YOUR_SSH_KEY_UUID']
  })
});

const server = await response.json();
console.log(server.uuid, server.status);

$data = [
    'hostname' => 'web-01',
    'location_id' => 1,
    'plan_uuid' => '3bc2faf6-8f8b-4978-b62d-b52ed3f858e9',
    'operating_system_version_uuid' => 'c3418f90-80a0-4e00-a7e1-d0ab1822b941',
    'ssh_key_uuids' => ['YOUR_SSH_KEY_UUID']
];

$ch = curl_init('https://admin.vps.org/api/v1/servers/');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$server = json_decode(curl_exec($ch), true);
curl_close($ch);

Voorbeeldantwoord

201 geskep met die volledige bediener voorwerp beskryf onder Kry bediener Details. Adresse en bmid word gevul in eens ontplooiing einde.

{
  "uuid": "5f0c8e2a-6b1d-4c3e-9a7f-2d4b6c8e0a1f",
  "hostname": "web-01",
  "vmid": null,
  "status": "queue",
  "error_description": null,
  "location": {
    "id": 1,
    "name": "New Jersey",
    "country_name": "United States",
    "is_active": true
  },
  "plan": {
    "uuid": "3bc2faf6-8f8b-4978-b62d-b52ed3f858e9",
    "cpu": 1,
    "ram": 2,
    "ram_unit": "GB",
    "disk_space": 10,
    "disk_space_total": 10240,
    "transfer": 500,
    "price": "3.50",
    "cpu_type_name": "Shared",
    "is_active": true,
    "hourly_price": "0.005",
    "monthly_price": "3.50",
    "is_gpu": false,
    "gpu_count": 0,
    "gpu_model": ""
  },
  "operating_system": {
    "id": 1,
    "name": "Ubuntu",
    "svg_icon": "<svg ...>",
    "versions": [ ... ]
  },
  "operating_system_version": {
    "uuid": "c3418f90-80a0-4e00-a7e1-d0ab1822b941",
    "name": "24.04 LTS x64",
    "os_name": "Ubuntu",
    "os_svg_icon": "<svg ...>",
    "is_active": true
  },
  "ipv4_addresses": [],
  "ipv6_addresses": [],
  "deployed": false,
  "created_at": "2026-09-14T21:02:11.402113Z",
  "recent_actions": []
}

Reaksiestatuskodes

201	Bediener geskep en wag vir ontplooiing
400	Geldige fout byvoorbeeld 'n onaktiewe ligging, plan of beheerstelsel weergawe
402	Geen betalingsmetode op lêer, onbetaalde fakture of die kaart pre-authorisering is geweier nie
403	Ontbrekende of ongeldige API-bewys, of die teken het nie die nodige toestemming nie
429	U rekening het sy bediener-skeppingsgrens bereik

KRY /api/v1/servers/{uuid}/

Kry bedienerbesonderhede

Gee een bediener terug met sy ligging, plan, operating stelsel, IP-adresse en die vyf mees onlangse aksies.

Benodigde toestemming: servers:list

curl -X GET "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Voorbeeldantwoord

{
  "uuid": "8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b",
  "hostname": "web-01",
  "vmid": 1042,
  "status": "on",
  "error_description": null,
  "location": {
    "id": 1,
    "name": "New Jersey",
    "country_name": "United States",
    "is_active": true
  },
  "plan": {
    "uuid": "14186969-fbaf-43e1-9ab2-b1f1aeb66674",
    "cpu": 1,
    "ram": 2,
    "ram_unit": "GB",
    "disk_space": 25,
    "disk_space_total": 25600,
    "transfer": 1,
    "price": "5.00",
    "cpu_type_name": "Shared",
    "is_active": true,
    "hourly_price": "0.007",
    "monthly_price": "5.00",
    "is_gpu": false,
    "gpu_count": 0,
    "gpu_model": ""
  },
  "operating_system": {
    "id": 1,
    "name": "Ubuntu",
    "svg_icon": "<svg ...>",
    "versions": [ ... ]
  },
  "operating_system_version": {
    "uuid": "c3418f90-80a0-4e00-a7e1-d0ab1822b941",
    "name": "24.04 LTS x64",
    "os_name": "Ubuntu",
    "os_svg_icon": "<svg ...>",
    "is_active": true
  },
  "ipv4_addresses": [
    {
      "ip": "203.0.113.10",
      "gateway": "203.0.113.1",
      "subnet": "203.0.113.0",
      "rdns": "web-01.example.com"
    }
  ],
  "ipv6_addresses": [
    {
      "ip": "2001:db8:2:dd::f9:6b",
      "gateway": "2001:db8:2:dd::f9:1",
      "subnet": "2001:db8:2:dd::f9:0",
      "rdns": "web-01.example.com"
    }
  ],
  "deployed": true,
  "created_at": "2026-07-30T03:54:14.914364Z",
  "recent_actions": [
    {
      "id": 17028,
      "action": "create",
      "action_display": "Create",
      "description": "Server deployed with VMID 1042",
      "user_email": "you@example.com",
      "created_at": "2026-07-30T03:54:32.860854Z"
    }
  ]
}

SVG-ikoonmerk en die weergaweslys word hier verkort.

Antwoordvelde

Veld	Tipe	Beskrywing
`vmid`	integer \| null	Virtuele masjien nommer, stel gedurende ontplooiing
`location`	object	Ligging voorwerp, soos teruggekeer deur die liggings API
`plan`	object	Plan object, soos teruggestuur deur die Plans API
`operating_system`, `operating_system_version`	object	Operating stelsel en die geïnstalleerde weergawe, soos teruggegee deur die Operating Systems API
`ipv4_addresses`, `ipv6_addresses`	array	Een voorwerp per adres met ip, poort, subnet en dens (die omgekeerde Dns masjien naam)
`recent_actions`	array	Tot vyf jongste aksies: id, aksie, aksie_disspeel, beskrywing, gebruiker_email, geskep_at

Reaksiestatuskodes

200	Bedienerbesonderhede suksesvol verkry
404	Nie gevind nie, of dit behoort aan 'n ander rekening

KRY /api/v1/servers/{uuid}/status/

Kry Bediener Status

'n Lig lig vra om te stem nadat jy skep, krag of hervergroot' n bediener.

curl -X GET "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/status/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "status": "on",
  "deployed": true,
  "resizing": false
}

Bediener Status waardes

Waarde	Beskrywing
`queue`	' n Aksie (deplooi, mag, hervergroot, herstel) is wagtoue of in vordering
`deploying`	Om georganiseerd te wees. Bedieners wat van die beheerpaneel geskep is, gebruik hierdie staat; bedieners geskep deur die API bly in wagtou totdat hulle gereed is.
`on`	Wat loop
`off`	Afskakel
`error`	Die laaste aksie het gevaal. Sien fout_description.
`suspended_payment`	Verboet weens onbetaalde fakture

AGT /api/v1/servers/{uuid}/power/

Beheer Bedienerkrag

Wagtou 'n krag aksie. Die bediener status verander na wag totdat die aksie voltooi.

Benodigde toestemming: servers:power

Versoekliggaamparameters

Parameter	Tipe	Vereis	Beskrywing
`action`	string	Ja	`start`: krag op `shutdown`: Op'n grasieuse afsluiting, wat nie afgebreek word as die gas nie ophou nie `restart`: Harde kragsiklus (stop, dan begin) `stop`: Doen tans dieselfde krag siklus as herbegin. Gebruik afskakel na los 'n bediener af.

Voorbeeldversoek

cURL

Python

curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/power/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "restart"}'

import requests

server_uuid = "8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b"
url = f"https://admin.vps.org/api/v1/servers/{server_uuid}/power/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.post(url, headers=headers, json={"action": "restart"})
print(response.json())

Voorbeeldantwoord

{
  "message": "Server restart queued"
}

Reaksiestatuskodes

200	Die aksie is getou
400	Vermis of nieondersteunde aksie
402	begin weier omdat die rekening onbetaalde fakture het
404	Nie gevind nie, of dit behoort aan 'n ander rekening

AGT /api/v1/servers/{uuid}/resize/

Hervergroot 'n Bediener

Skuif die bediener na 'n ander aktiewe plan. Die nuwe plan kan nie minder skyfspasie as die huidige een hê nie, en die versoek liggaam moet aksie stel insluit om te hervergroot. Hypervisor se vermoë vir die nuwe plan is nagegaan voordat enigiets getou is, so 'n geweier versoek laat die bediener onveranderd.

Die bediener is gesluit terwyl dit is geskaleer en beginne weer daarna. As die hervergroot vaal, die bediener is teruggesit op sy vorige plan en beginne weer as dit was wat loop. Disket groei kan nie wees ondoen.

Benodigde toestemming: servers:resize

Versoekliggaamparameters

Parameter	Tipe	Vereis	Beskrywing
`action`	string	Ja	moet wees hervergroot
`new_plan_uuid`	string	Ja	Die uUID van die plan om na te trek

curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/resize/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "resize", "new_plan_uuid": "5e26a4a6-bd0c-467c-abca-da036c811c3f"}'

{
  "message": "Resize queued successfully"
}

Example of a refused resize (409):

{
  "error": "Not enough hypervisor capacity for the selected plan; the server was not changed"
}

Reaksiestatuskodes

200	Die aksie is getou
400	Vermiste aksie of nuwe_plan_uïde, ongeldige of onaktiewe plan, 'n plan met minder disket spasie, of' n GPU plan (GPU planne kan nie deur die API) geskaleer word nie
404	Nie gevind nie, of dit behoort aan 'n ander rekening
409	'n Vergrote of bergingsverandering is reeds aan die gang, of daar is nie genoeg hipervisor vermoë vir die nuwe plan nie
503	Kapasiteit kon nie nou nagegaan word nie. Die bediener was nie verander; probeer later.

AGT /api/v1/servers/{uuid}/reset-password/

Herstel root Wagwoord

Genereer 'n nuwe root wagwoord, gee terug dit in Die antwoord en wagtoue Die verander op die bediener. Die nuwe wagwoord is asook e- pos na jy. Die bediener moet wees geÃ ̄neer word. Nee versoek liggaam is benodig.

curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/reset-password/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "message": "Password reset queued. New password will also be emailed to you.",
  "password": "generated-password",
  "job_id": "b6f1c7e2-3a4d-4f5e-8b9c-0d1e2f3a4b5c"
}

Reaksiestatuskodes

200	Die aksie is getou
400	Die bediener is nog nie geÃ ̄nuis nie
404	Nie gevind nie, of dit behoort aan 'n ander rekening

KRY AGT /api/v1/servers/{uuid}/rdns/

Keer DNS (PTSV) om

KLK lyste die omgekeerde Dns masjien naam van elke IPv4 en IPv6 adres op die bediener. POS verstel dit vir een adres. Stuur 'n leë masjien naam herstel die adres na sy verstek omgekeerde Dns naam.

Benodigde toestemming: servers:update

Versoekliggaamparameters (POST)

Parameter	Tipe	Vereis	Beskrywing
`ip`	string	Ja	'n IPv4 of IPv6 adres wat aan hierdie bediener toegewys is
`hostname`	string	Nee	Die PTR masjien naam. Laat leeg na herstel na die verstek.

curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/rdns/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ip": "203.0.113.10", "hostname": "mail.example.com"}'

{
  "message": "Reverse DNS for 203.0.113.10 set to mail.example.com",
  "ip": "203.0.113.10",
  "hostname": "mail.example.com"
}

KRY antwoord:

{
  "rdns": [
    {"ip": "203.0.113.10", "hostname": "mail.example.com"},
    {"ip": "2001:db8:2:dd::f9:6b", "hostname": "mail.example.com"}
  ]
}

Reaksiestatuskodes

400	ip ontbreek, of die gasheernaam kon nie gestel word nie
404	Die IP-adres is nie aan hierdie bediener gegee nie

AGT /api/v1/servers/{uuid}/exec/

Hardloop 'n opdrag op 'n bediener

Loop 'n tolk opdrag binne in die bediener deur die QEMU gas agent en wag vir dit na klaar. Die bediener moet wees ontplooi en loop, en qemu-mest-agent moet wees geïnstalleer en hardloop in die gas.

Benodigde toestemming: servers:exec

Versoekliggaamparameters

Parameter	Tipe	Vereis	Beskrywing
`command`	string	Ja	Opdraglyn loop met /bin/sh -c, tot 2000 karakters
`timeout`	integer	Nee	Sekondes om vir die bevel te wag, 1 tot 300 (verstek 30)

curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/exec/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"command": "uptime", "timeout": 30}'

{
  "stdout": " 21:14:03 up 46 days,  2:10,  0 users,  load average: 0.08, 0.03, 0.01\n",
  "stderr": "",
  "exit_code": 0,
  "timed_out": false
}

As die opdrag nog loop wanneer die tydverstreke vertrek, het die antwoord tyd_uit gestel na waar en beÃ ̄endig_kode stel om te null.

Reaksiestatuskodes

200	Opdrag klaar of tydgebonde uit
400	Bediener nie gebruik word nie of nie loop, of ongeldige parameters
409	Die QEMU-gasagent loop nie op die bediener nie
503	Tydelike verbinding probleem. Herprobeer na die herprobeer- na opskrif.

VERWYDER /api/v1/servers/{uuid}/

Vee bediener uit

Wagtou die bediener vir permanente uitveeÃ ̄ng. Die bediener verdwyn van die lys onmiddellik en kan nie herwin word nie.

Benodigde toestemming: servers:delete

curl -X DELETE "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "message": "Server deletion queued"
}

Reaksiestatuskodes

202	Aanvaar: die versoek is getou
404	Nie gevind nie, of dit behoort aan 'n ander rekening

KRY AGT /api/v1/ssh-keys/

SSH-sleutels waarskuwing

Stoor openbare SSH-sleutels in jou rekening, dan stuur aan hulle uUID's as ssh_key_uuids wanneer jy 'n bediener skep. KRY lyste jou sleutels (25 per bladsy); OT voeg een by.

Benodigde toestemming: ssh-keys:list (GET), ssh-keys:create (POST)

Versoekliggaamparameters (POST)

Parameter	Tipe	Vereis	Beskrywing
`name`	string	Ja	'n Naam om die sleutel te herken deur, tot 100 karakters
`public_key`	string	Ja	Die publieke sleutel in OpenSH formaat, byvoorbeeld die inhoud van id_ed25519.pub

Voorbeeldversoek

cURL

Python

curl -X POST "https://admin.vps.org/api/v1/ssh-keys/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "laptop", "public_key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI... you@laptop"}'

import requests

url = "https://admin.vps.org/api/v1/ssh-keys/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

with open("/home/you/.ssh/id_ed25519.pub") as f:
    data = {"name": "laptop", "public_key": f.read().strip()}

response = requests.post(url, headers=headers, json=data)
print(response.status_code, response.json()["uuid"])

Voorbeeldantwoord

{
  "id": 19,
  "uuid": "6e1b9c52-3f8a-4d7e-a2c4-5b9d0e1f2a3c",
  "name": "laptop",
  "public_key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI... you@laptop",
  "fingerprint": "0b:4c:9b:48:76:e7:1d:07:b9:ac:71:90:70:f7:9a:69",
  "created_at": "2026-08-23T19:16:11.547183Z",
  "last_used_at": null
}

Antwoordvelde

Veld	Tipe	Beskrywing
`id`, `uuid`	integer, string	Sleutelidentifiseerders. Gebruik uid in ssh_key_uuids en in die URL hieronder; id werk in ssh_key_ids.
`fingerprint`	string	MD5 vingerafdruk van die sleutel, bereken deur die platform
`last_used_at`	datetime \| null	Wanneer die sleutel laas geïnstalleer was op 'n nuwe bediener

Reaksiestatuskodes

201	Sleutel bygevoeg
400	Ontbrekende naam, of die publieke sleutel is nie 'n geldige SSH- publieke sleutel nie

KRY VERWYDER /api/v1/ssh-keys/{uuid}/

Kry of skrap 'n SSH-sleutel

Ry terug een sleutel met die velde hierbo. DEETE verwyder dit van jou rekening en gee terug 204 met geen liggaam. Deur 'n sleutel te skrap, verwyder dit nie van bedieners wat reeds geïnstalleer is nie. Sleutels kan nie geredigeer word nie: uitvee en voeg by.

Benodigde toestemming: ssh-keys:list (GET), ssh-keys:delete (DELETE)

curl -X DELETE "https://admin.vps.org/api/v1/ssh-keys/6e1b9c52-3f8a-4d7e-a2c4-5b9d0e1f2a3c/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Rugsteun en Kiek

Te skep van 'n rugsteun of' n kiek is asook 'n bediener aksie:

POST /api/v1/servers/{uuid}/backup/: Rugsteun-API
POST /api/v1/servers/{uuid}/snapshot/: Kiek API

VPS.org API

Lys alle bedieners

Navraagparameters

Voorbeeldversoek

Voorbeeldantwoord

Antwoordvelde

Reaksiestatuskodes

Skep Nuwe Bediener

Versoekliggaamparameters

Voorbeeldversoek

Voorbeeldantwoord

Reaksiestatuskodes

Kry bedienerbesonderhede

Voorbeeldantwoord

Antwoordvelde

Reaksiestatuskodes

Kry Bediener Status

Bediener Status waardes

Beheer Bedienerkrag

Versoekliggaamparameters

Voorbeeldversoek

Voorbeeldantwoord

Reaksiestatuskodes

Hervergroot 'n Bediener

Versoekliggaamparameters

Reaksiestatuskodes

Herstel root Wagwoord

Reaksiestatuskodes

Keer DNS (PTSV) om

Versoekliggaamparameters (POST)

Reaksiestatuskodes

Hardloop 'n opdrag op 'n bediener

Versoekliggaamparameters

Reaksiestatuskodes

Vee bediener uit

Reaksiestatuskodes

SSH-sleutels waarskuwing

Versoekliggaamparameters (POST)

Voorbeeldversoek

Voorbeeldantwoord

Antwoordvelde

Reaksiestatuskodes

Kry of skrap 'n SSH-sleutel

Rugsteun en Kiek