VPS.org API

Litokomane tsa REST API

Liseva tsa API

E etsa, e bona, e matlafatsa, e fetola boholo ba eona le ho tlosa liserver tsa hau tsa VPS. Liserver li bonts'itsoe ka uuid ea tsona.

Mafelo a ho Qetela 15
Tsela ea Motheo /api/v1/servers
FUMANA /api/v1/servers/

Thathamisa Li-server Tsohle

E khutlisa liservers ka akhaonteng ea hau, e ncha pele, 25 ka leqephe. Liservers tse tlositsoeng ha li kenyeletsoe.

Litokelo li hlokahale: servers:list

Liparamitha tsa Potso

Parameter Mofuta E hlokahala Bophara
page integer Ha ho joalo Page number, starting at 1
page_size integer Ha ho joalo Liphetho ka leqephe (ka ho tloaeleha 25, ho feta 100)

Kopo ea Mohlala

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";
}

Karabo ea Mohlala

{
  "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
    }
  ]
}

Masimo a Karabo

Setereke Mofuta Bophara
uuid string Setsebiso sa sebatli se sebelisoang ka hohle ho server endpoint
hostname string Lebitso la mofani oa sebaka seo u se khethileng ha u etsa sebatli
status string Mofuta oa hona joale. Bona Litheko tsa Mofuta oa Setsi ka tlase.
error_description string | null Lintlha tsa ho hloleha ha morao ha boemo bo le bothata, haeba ho le joalo null
location_name string Lebitso la sebaka seo sephutheloana se sebetsang ho sona
os_name string Lebitso la sistimi ea ho sebetsa, ntle le mofuta
plan_name string Litlhaku tse ka balahang tsa merero, mohlala 1 vCPU / 2 GB RAM / 10 GB
ipv4_addresses array Direkoto tsa IPv4 e le lihlooho. E le bobebe ho fihlela setsi se kenngoa, le ho li-plans tse se nang IPv4.
ipv6_addresses array Direkoto tsa IPv6 e le lihlooho. E le bobebe ho fihlela setsi se kenngoa.
created_at datetime Nako ea ho theha (ISO 8601, UTC)
deployed boolean Ho_baneng ha ho etsoa

Likhoutu tsa Boemo ba Karabelo

200 Lenane la seva le fumanoeng ka katleho
403 Token ea API e sa nepahalang kapa e sa fumaneheng, kapa token e na le litokelo tse hlokahalang
POST /api/v1/servers/

Theha Seva e Ncha

E tlisa server e ncha kapele ho kenya'me khutlisa kapele le ho kenya kapele. Ho fana ka litšebeletso ho tsoela pele ka morao: ho hlahloba boemo ba ho qetela ho fihlela ho kenya ho utloahala. Ha server e le teng, lintlha tsa ho kena li romelloa ka lengolo tsoibila ho motsamaisi oa ak'haonte.

Akaunti ea hau e hloka mokhoa oa ho lefa o bolokiloeng. Ho latela nalane ea ak'haonte ea hau, ho ka ba le ho kopanngoa ha nakoana ho fihlela beke e le 'ngoe ea theko ea qeto (ho ka ba 1 USD ka tlase ho) ho ka kenngoa kareteng ea hau pele ho theha setsi.

Litokelo li hlokahale: servers:create

Kopa Liparamente tsa 'Mele

Parameter Mofuta E hlokahala Bophara
hostname string E Ho ka tlase ho li-characters tse 3. Li-letters, li-digits, hyphens le li-points feela.
location_id integer E ID ea sebaka se sebetsang ho tloha ho Locations API
plan_uuid string E UID ea qeto e sebetsang ho tloha ho API ea qeto
operating_system_version_uuid string E UID ea ho kenya e sebetsang ho lenane la liphetoho tsa sistimi ea ts'ebetso
ssh_key_uuids array Ha ho joalo UUIDs tsa li-keys tsa SSH ho tloha ho SSH Keys API ho kenya ho sebatli
ssh_key_ids array Ha ho joalo Li-ID tsa li-integer tsa li-keys tsa SSH, e le khetho ho ssh_key_uuids. Haeba li romelloa ka bobeli, ssh_key_ids e sebelisoa.
ssh_key_uuid, ssh_key_id string, integer Ha ho joalo Litlhaku tse khuts'oane tsa konopo e le 'ngoe ea SSH
auth_method string Ha ho joalo Lentsoe la phapusing, ssh_key kapa ka bobeli. Ka ho tloaeleha ke lentsoe la phapusing, kapa ka bobeli ha li-keys tsa SSH li fanoa.

Kopo ea Mohlala

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);

Karabo ea Mohlala

201 E entsoe ka ntho e feletseng ea server e hlalositsoeng ka tlase ho Fumana Lintlha tsa Server. Direktha le vmid li tlamehile ha ho etsoa ho kenya.

{
  "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": []
}

Likhoutu tsa Boemo ba Karabelo

201 Server e entsoe mme e buloa bakeng sa ho kenya
400 Phapang ea ho nepahala, mohlala, sebaka se sa sebetsanang, qeto kapa mofuta oa sistimi ea ho sebetsa
402 Ha ho na tsela ea ho lefa ka file, li-invoice tse sa lefelloeng, kapa ho saennoa pele ha karete ho laoloa
403 Token ea API e sa nepahalang kapa e sa fumaneheng, kapa token e na le litokelo tse hlokahalang
429 Akaunti ea hau e fihla ho tekanyetso ea ho theha setsi sa eona
FUMANA /api/v1/servers/{uuid}/

Fumana Lintlha tsa Seva

E khutlisa motsamaisi e mong le e mong le sebaka sa hae, merero, sistimi ea ho sebetsa, IP addresses le liphetoho tse tharo tse fetileng.

Litokelo li hlokahale: servers:list

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

Karabo ea Mohlala

{
  "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"
    }
  ]
}

Li-markup tsa SVG tsa li-icon le lenane la li-version li khutsufalitsoe mona.

Masimo a Karabo

Setereke Mofuta Bophara
vmid integer | null Sehlopha sa Virtual Machine, se hlophisitsoeng ha se sebelisoa
location object Motheo oa sebaka, joalo ka ha e khutlisoa ke Locations API
plan object Motheo oa li-plan, joalo ka ha e khutlisoa ke API ea li-Plans
operating_system, operating_system_version object Sisteme ea ho sebetsa le mofuta o kentsoeng, joalo ka ha e romelloa ke API ea Li-Operating Systems
ipv4_addresses, ipv6_addresses array Sehlooho se le seng ka lengolo-tsoibila leng le nang le ip, gateway, subnet le rdns (lebitso la mohala oa DNS o fetotsoeng)
recent_actions array Ho fihlela ho liphetoho tse tharo tse fetileng: id, action, action_display, description, user_email, created_at

Likhoutu tsa Boemo ba Karabelo

200 Lintlha tsa seva li fumanoe ka katleho
404 Ha e fumanehe, kapa e na le akhaonto e 'ngoe
FUMANA /api/v1/servers/{uuid}/status/

Fumana boemo ba mosebeletsi

E le ho kopa ho kopanngoa ha lipotso ka mor'a hore u etse, u matlafatse kapa u fetole boholo ba setsi.

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
}

Litheko tsa boemo ba setsi

Litšenyehelo Bophara
queue Ho na le qeto (ho kenya, ho matlafatsa, ho fetola boholo, ho khutlisa) e le ka lebokoseng kapa e ntse e tsoela pele
deploying Ho etsoa liteko. Li-server tse entsoeng ho tloha panel ea taolo li sebelisa sena; li-server tse entsoeng ka API li lula li le liphuthelong ho fihlela li le teng.
on Ho sebetsa
off E se e hokahane
error Ho etsa qeto e fetileng ho sa khone. Bona error_description.
suspended_payment E sa tsoa qala
POST /api/v1/servers/{uuid}/power/

Ho laola matla a sebatli

E arolelana qeto ea matla. Tlhoko ea sebatli e fetoha ho arolelana qeto ho fihlela qeto e felile.

Litokelo li hlokahale: servers:power

Kopa Liparamente tsa 'Mele

Parameter Mofuta E hlokahala Bophara
action string E start: ho kenya matla
shutdown: ho koaloa ka ho phethahetseng, ho koaloa ka matla haeba moahi a sa khutle
restart: ho tjhaja ka matla a maholo (ho khutlela morao, ebe ho qala)
stop: kajeno e etsa ts'ebetso ea matla e tšoanang le ho qala ka ho hlaka. Sebelisa shutdown ho tlohela setšeng e sebetse.

Kopo ea Mohlala

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())

Karabo ea Mohlala

{
  "message": "Server restart queued"
}

Likhoutu tsa Boemo ba Karabelo

200 Ts'ebetso e ne e le ka lebokoseng
400 Ho se na qeto kapa qeto e sa tšehetsoang
402 qala e sa lumelloa hobane akhaonto e na le li-invoice tse sa lefelloeng
404 Ha e fumanehe, kapa e na le akhaonto e 'ngoe
POST /api/v1/servers/{uuid}/resize/

Ho fetola boholo ba server

E tlisa sebatli ho leano le leng le sebetsang. Leano le ncha ha le na sebaka sa disk se tlase ho sa leano le kajeno,'me' mele oa kopo o lokela ho kenyelletsa qeto ea ho fetola boholo. Boholo ba Hypervisor bakeng sa leano le ncha bo tla hlahlojoa pele ho e' ngoe e le kapele, ka hona kopo e sa lumelloeng e tla etsa hore sebatli se se ke sa fetoha.

Motsamaisi o tla buloa ha o ntse o fetolela boholo ba eona'me o qala hape ka mor'a moo. Haeba ho fetolela boholo ho sa atlehe, motsamaisi o tla khutlisoa ho qeto ea hae ea pele'me o qala hape haeba o ntse o sebetsa. Ho hōla ha diski ha ho ka tlosoa.

Litokelo li hlokahale: servers:resize

Kopa Liparamente tsa 'Mele

Parameter Mofuta E hlokahala Bophara
action string E Ho lokela ho fetoloa boholo
new_plan_uuid string E UID ea merero e tla ntlafatsoa 
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"
}

Mohlala oa ho tlosoa ha boholo bo khutsitseng (409):

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

Likhoutu tsa Boemo ba Karabelo

200 Ts'ebetso e ne e le ka lebokoseng
400 Ho se na qeto kapa new_plan_uuid, qeto e sa nepahalang kapa e sa sebetsaneng, qeto e nang le sebaka se fokolang sa disk, kapa qeto ea GPU (qeto ea GPU e ke ke ea fetoloa ka API)
404 Ha e fumanehe, kapa e na le akhaonto e 'ngoe
409 Ho fetoha ha boholo kapa ho boloka ho ntse ho tsoela pele, kapa ha ho na bokhoni bo lekaneng ba hypervisor bakeng sa qeto e ncha
503 Boholo bo ka se ke ba hlahlojoa hona joale. Motsamaisi ha a fetotsoe; leka hape ka mor'a moo.
POST /api/v1/servers/{uuid}/reset-password/

Lekola Lentsoe la _Sephiri

E hlahisa lentsoe la phapusing le lecha la root, le e khutlisa ka karabo'me le kenya ho fetoloa ho server. Lentsoe la phapusing le lecha le romelloa ka imeile ho uena. Server e lokela ho kenngoa. Ha ho hlokahale hore ho be le lentsoe la kopo.

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"
}

Likhoutu tsa Boemo ba Karabelo

200 Ts'ebetso e ne e le ka lebokoseng
400 Motsamaisi oa setsi ha a na ho kenya
404 Ha e fumanehe, kapa e na le akhaonto e 'ngoe
FUMANA POST /api/v1/servers/{uuid}/rdns/

DNS e khutsitseng (PTR)

GET e bonts'a lebitso la moamoheli oa DNS o fetotsoeng oa IPv4 le IPv6 ka mong le lengolo-tsoibila la seva. POST e beha ho lengolo-tsoibila leng. Ho romella lebitso la moamoheli le lefifi le khutlisa lengolo-tsoibila ho lebitso la DNS le fetotsoeng la eona la default.

Litokelo li hlokahale: servers:update

Kopa Liparamente tsa 'Mele (POST)

Parameter Mofuta E hlokahala Bophara
ip string E Lengolo-tsoibila la IPv4 kapa IPv6 le romelloang ho sebatli sena
hostname string Ha ho joalo Lebitso la mohala oa PTR. E siee e le khuts'oane ho e fetola ho e tloaelehileng. 
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"
}

Likarabo tsa GET:

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

Likhoutu tsa Boemo ba Karabelo

400 ip e sa fumanehe, kapa lebitso la moamoheli le sa ka la hlophisoa
404 Lengolo-tsoibila la IP ha le behiloe ho sebatli sena
POST /api/v1/servers/{uuid}/exec/

E_a ho Server

E phethela molaoli oa shell kahare ho sebatli ka ho sebelisa mokhatlo oa QEMU oa baeti'me e lekola hore e qetelle. Sebatli se lokela ho ba se kopantsoeng le ho sebetsa, le qemu-guest-agent se lokela ho hokahanngoa le ho sebetsa ho baeti.

Litokelo li hlokahale: servers:exec

Kopa Liparamente tsa 'Mele

Parameter Mofuta E hlokahala Bophara
command string E E sebetsa ka lebokoseng la litaelo le /bin/sh -c, ho fihlela ho li-characters tse 2000
timeout integer Ha ho joalo Lisekoere tse ka tlamang ho fihlela ho laeloa, 1 ho isa ho 300 (ho nepahala ke 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
}

Haeba molaoli o ntse o sebetsa ha nako e fela, karabo e na le timed_out e khethehileng e le 'nete'me exit_code e khethehileng e le null.

Likhoutu tsa Boemo ba Karabelo

200 Motsamaisi oa litaelo
400 Motsamaisi ha a sebelisetsoe kapa ha a sebetsane, kapa liparamita ha li nepahale
409 Motsamaisi oa moahi oa QEMU ha a sebetsane le sebatli
503 Ho na le bothata ba ho kopanya ka nakoana. Tseba hape ka mor'a ho leka-leha-kamora.
Hlakola /api/v1/servers/{uuid}/

Hlakola Seva

E tlisa server ho phutheloana bakeng sa ho tlosoa ka ho sa feleng. Server e tla fela ho tsoa ho lenane kapele mme e ke ke ea khutlisoa.

Litokelo li hlokahale: 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"
}

Likhoutu tsa Boemo ba Karabelo

202 E amohetse: kopo e kenngoa kapele
404 Ha e fumanehe, kapa e na le akhaonto e 'ngoe
FUMANA POST /api/v1/ssh-keys/

Li-keys tsa SSH

Ho boloka li-keys tsa SSH tsa sechaba akhaonteng ea hau, ebe u fetisa li-uuids tsa tsona e le ssh_key_uuids ha u theha setsi. GET e bonts'a li-keys tsa hau (25 ka leqephe); POST e eketsa e le 'ngoe.

Litokelo li hlokahale: ssh-keys:list (GET), ssh-keys:create (POST)

Kopa Liparamente tsa 'Mele (POST)

Parameter Mofuta E hlokahala Bophara
name string E Lebitso la ho tsebahala ha konopo, ho fihlela ho li-character tse 100
public_key string E Mofuta oa konopo ea sechaba ea OpenSSH, mohlala, se boletsoeng ka id_ed25519.pub

Kopo ea Mohlala

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"])

Karabo ea Mohlala

{
  "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
}

Masimo a Karabo

Setereke Mofuta Bophara
id, uuid integer, string Li-identifiers tsa konopo. Sebelisa uuid ka ssh_key_uuids le ka URL e ka tlase; id e sebetsa ka ssh_key_ids.
fingerprint string Fingerprint ea MD5 ea konopo, e behiloeng ke platform
last_used_at datetime | null Ha konopo e kenngoa ka ho qetela ho sebatli se secha

Likhoutu tsa Boemo ba Karabelo

201 Key e kenyelelitsoe
400 Lebitso le sa fumaneheng, kapa konopo ea sechaba ha e na konopo e sebetsang ea sechaba sa SSH
FUMANA Hlakola /api/v1/ssh-keys/{uuid}/

Fumana kapa tlosa setsi sa SSH

GET e khutlisa konopo e le 'ngoe le libaka tse ka holimo. DELETE e e tlosa ho akhaonteng ea hau mme e khutlisa 204 ntle le'mele. Ho tlosa konopo ha ho e tlose ho li-servers tseo e neng e kenya. Likonopo ha li ka fetoloa: tlosa ebe u li eketsa hape.

Litokelo li hlokahale: 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"

Likopi tsa polokelo le lifoto

Ho etsa backup kapa snapshot ke qeto ea server: