API serverov

ZÍSKAŤ /api/v1/servers/

Zoznam všetkých serverov

Vráti servery vo vašom konte, najnovšie ako prvé, 25 na stránku, servery, ktoré sa odstraňujú, nie sú zahrnuté.

Požadované povolenie: servers:list

Parametre dopytu

Parameter	Typ	Povinné	Opis
`page`	integer	Nie	Číslo strany začínajúce na 1
`page_size`	integer	Nie	Výsledky na stránku (predvolené 25, maximálne 100)

Príklad žiadosti

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

Príklad odpovede

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

Polia odpovede

Pole	Typ	Opis
`uuid`	string	Identifikátor servera používaný v každom inom koncovom bode servera
`hostname`	string	Názov hostiteľa, ktorý ste si vybrali pri vytváraní servera
`status`	string	Aktuálny stav. Pozrite si časť Hodnoty stavu servera nižšie.
`error_description`	string \| null	Podrobnosti o poslednom zlyhaní, ak je stav chyba, inak null
`location_name`	string	Názov miesta, kde server beží
`os_name`	string	Názov operačného systému bez verzie
`plan_name`	string	Čítateľný súhrn plánu, napríklad 1 vCPU / 2 GB RAM / 10 GB
`ipv4_addresses`	array	IPv4 adresy ako reťazce. Prázdne, kým nie je server nasadený, a v plánoch bez IPv4.
`ipv6_addresses`	array	IPv6 adresy ako reťazce. Prázdne, kým nie je server nasadený.
`created_at`	datetime	Čas vytvorenia (ISO 8601, UTC)
`deployed`	boolean	True po dokončení zriadenia

Kódy stavu odpovede

200	Zoznam serverov bol úspešne načítaný
403	Chýbajúci alebo neplatný token API alebo token nemá požadované povolenie

POST /api/v1/servers/

Vytvoriť nový server

Pridá nový server do frontu na nasadenie a okamžite ho vráti so stavovým frontom.Provisioning pokračuje na pozadí: dotazovanie koncového bodu stavu, kým sa nenasadí hodnota true.Keď je server pripravený, jeho prihlasovacie údaje sa odošlú e-mailom vlastníkovi konta.

V závislosti od histórie vášho účtu môže byť pred vytvorením servera na vašej karte vykonaná dočasná predbežná autorizácia vo výške približne týždennej ceny plánu (minimálne 1 USD), ktorá sa môže použiť na zaplatenie poplatkov za predplatné, ktoré ste si vybrali.

Požadované povolenie: servers:create

Parametre tela požiadavky

Parameter	Typ	Povinné	Opis
`hostname`	string	Áno	Najmenej 3 znaky. Iba písmená, číslice, spojovníky a bodky.
`location_id`	integer	Áno	ID aktívneho miesta z rozhrania Locations API
`plan_uuid`	string	Áno	UID aktívneho plánu z rozhrania Plans API
`operating_system_version_uuid`	string	Áno	UID aktívnej položky v zozname verzií operačného systému
`ssh_key_uuids`	array	Nie	UUID SSH kľúčov z API SSH Keys, ktoré sa majú nainštalovať na server
`ssh_key_ids`	array	Nie	Celočíselné ID SSH kľúčov, ako alternatíva k ssh_key_uuids. Ak sú odoslané obe, použije sa ssh_key_ids.
`ssh_key_uuid`, `ssh_key_id`	string, integer	Nie	Skratka pre jeden SSH kľúč
`auth_method`	string	Nie	Predvolené nastavenie je heslo, alebo oboje, ak sú poskytnuté SSH kľúče.

Príklad žiadosti

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

Príklad odpovede

201 Vytvorené s objektom plného servera popísaným v časti Získať podrobnosti o serveri Adresy a vmid sa vyplnia po dokončení nasadenia.

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

Kódy stavu odpovede

201	Server vytvorený a zaradený do frontu na nasadenie
400	Chyba overenia, napríklad neaktívna lokalita, plán alebo verzia operačného systému
402	Žiadny spôsob platby v registri, nezaplatené faktúry alebo zamietnutie predbežnej autorizácie karty
403	Chýbajúci alebo neplatný token API alebo token nemá požadované povolenie
429	Váš účet dosiahol limit na vytvorenie servera

ZÍSKAŤ /api/v1/servers/{uuid}/

Získať podrobnosti o serveri

Vráti jeden server s jeho umiestnením, plánom, operačným systémom, IP adresami a piatimi najnovšími akciami.

Požadované povolenie: servers:list

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

Príklad odpovede

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

Značky SVG ikon a zoznam verzií sú tu skrátené.

Polia odpovede

Pole	Typ	Opis
`vmid`	integer \| null	Číslo virtuálneho stroja, nastavené počas nasadenia
`location`	object	Objekt Location vrátený rozhraním Locations API
`plan`	object	Objekt plánu vrátený rozhraním API pre plány
`operating_system`, `operating_system_version`	object	Operačný systém a nainštalovaná verzia vrátená rozhraním Operating Systems API
`ipv4_addresses`, `ipv6_addresses`	array	Jeden objekt na adresu s ip, gateway, subnet a rdns (reverse DNS hostname)
`recent_actions`	array	Až päť posledných akcií: id, action, action_display, description, user_email, created_at

Kódy stavu odpovede

200	Údaje o serveri boli úspešne načítané
404	Nenájdené, alebo patrí k inému účtu

ZÍSKAŤ /api/v1/servers/{uuid}/status/

Získať stav servera

Ľahké volanie na polling po vytvorení, napájaní alebo zmene veľkosti servera.

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
}

Hodnoty stavu servera

Hodnota	Opis
`queue`	Akcia (nasadiť, zapnúť, zmeniť veľkosť, obnoviť) je vo fronte alebo prebieha
`deploying`	Servery vytvorené z ovládacieho panela používajú tento stav; servery vytvorené prostredníctvom rozhrania API zostávajú vo fronte, kým nie sú pripravené.
`on`	Bežím.
`off`	Vypnuté
`error`	Posledná akcia zlyhala. Pozri error_description.
`suspended_payment`	Pozastavené kvôli nezaplateným faktúram

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

Ovládanie napájania servera

Stav servera sa zmení na front, kým sa akcia nedokončí.The server status changes to queue until the action completes.

Požadované povolenie: servers:power

Parametre tela požiadavky

Parameter	Typ	Povinné	Opis
`action`	string	Áno	`start`: Zapnutie `shutdown`: Elegantné vypnutie, nútené vypnutie, ak hosť nezastaví `restart`: cyklus tvrdého napájania (zastavenie, potom spustenie) `stop`: Server momentálne vykonáva rovnaký cyklus napájania ako reštart. Použite shutdown na ponechanie servera vypnutého.

Príklad žiadosti

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

Príklad odpovede

{
  "message": "Server restart queued"
}

Kódy stavu odpovede

200	Akcia bola zaradená do frontu
400	Chýbajúce alebo nepodporované akcie
402	Začiatok bol odmietnutý, pretože účet má nezaplatené faktúry
404	Nenájdené, alebo patrí k inému účtu

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

Zmena veľkosti servera

Presunie server na iný aktívny plán.Nový plán nemôže mať menej miesta na disku ako aktuálny a telo požiadavky musí obsahovať akciu nastavenú na zmenu veľkosti. Kapacita hypervisora pre nový plán sa skontroluje predtým, ako sa niečo zaradí do frontu, takže odmietnutá požiadavka ponechá server nezmenený.

Server sa vypne počas zmeny veľkosti a potom sa znova spustí. Ak zmena veľkosti zlyhá, server sa vráti do predchádzajúceho plánu a znova sa spustí, ak bol spustený.

Požadované povolenie: servers:resize

Parametre tela požiadavky

Parameter	Typ	Povinné	Opis
`action`	string	Áno	Musí byť zmenená veľkosť
`new_plan_uuid`	string	Áno	UID plánu, na ktorý sa má presunúť

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

Príklad odmietnutej zmeny veľkosti (409):

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

Kódy stavu odpovede

200	Akcia bola zaradená do frontu
400	Chýba akcia alebo new_plan_uuid, neplatný alebo neaktívny plán, plán s menším priestorom na disku alebo plán s GPU (veľkosť plánov s GPU sa nedá zmeniť prostredníctvom rozhrania API)
404	Nenájdené, alebo patrí k inému účtu
409	Zmena veľkosti alebo zmena ukladacieho priestoru už prebieha alebo hypervízor nemá dostatočnú kapacitu pre nový plán
503	Kapacitu sa momentálne nepodarilo skontrolovať. Server sa nezmenil, skúste to znova neskôr.

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

Resetovať root heslo

Generuje nové heslo roota, vráti ho v odpovedi a zmenu zadá do frontu na serveri. Nové heslo vám bude tiež zaslané e- mailom. Server musí byť nasadený. Nevyžaduje sa telo žiadosti.

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

Kódy stavu odpovede

200	Akcia bola zaradená do frontu
400	Server ešte nie je nasadený
404	Nenájdené, alebo patrí k inému účtu

ZÍSKAŤ POST /api/v1/servers/{uuid}/rdns/

Reverzný DNS (PTR)

GET vyhľadá reverzný DNS názov pre každú IPv4 a IPv6 adresu na serveri. POST ho nastaví pre jednu adresu. Odoslaním prázdneho názvu hostiteľa sa adresa resetuje na jej predvolený reverzný DNS názov.

Požadované povolenie: servers:update

Parametre tela požiadavky (POST)

Parameter	Typ	Povinné	Opis
`ip`	string	Áno	Adresa IPv4 alebo IPv6 priradená k tomuto serveru
`hostname`	string	Nie	Názov hostiteľa PTR. Nechajte prázdne pre resetovanie na predvolené hodnoty.

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

Odpoveď na GET:

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

Kódy stavu odpovede

400	Chýba IP adresa alebo názov hostiteľa sa nepodarilo nastaviť
404	IP adresa nie je priradená k tomuto serveru

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

Spustenie príkazu na serveri

Spustiť shell príkaz v serveri cez QEMU hosť agenta a čakať na jeho dokončenie.Server musí byť nasadený a beží, a qemu-guest-agent musí byť nainštalovaný a beží v hosťovi.

Požadované povolenie: servers:exec

Parametre tela požiadavky

Parameter	Typ	Povinné	Opis
`command`	string	Áno	Príkazový riadok spustený s /bin/sh -c, až 2000 znakov
`timeout`	integer	Nie	Počet sekúnd čakania na príkaz, 1 až 300 (predvolené 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
}

Ak je príkaz stále spustený po uplynutí časového limitu, odpoveď má timed_out nastavený na hodnotu true a exit_code nastavený na hodnotu null.

Kódy stavu odpovede

200	Príkaz skončil alebo vypršal čas
400	Server nie je nasadený alebo nie je spustený, alebo neplatné parametre
409	QEMU hosť agent nie je spustený na serveri
503	Dočasný problém s pripojením. Skúste to znova po hlavičke Retry-After.

ODSTRÁNIŤ /api/v1/servers/{uuid}/

Odstrániť server

Server sa okamžite vymaže zo zoznamu a nie je možné ho obnoviť.Server disappears from the list immediately and cannot be restored.

Požadované povolenie: 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"
}

Kódy stavu odpovede

202	Prijaté: požiadavka bola zaradená do frontu
404	Nenájdené, alebo patrí k inému účtu

ZÍSKAŤ POST /api/v1/ssh-keys/

SSH kľúče

Uložte verejné SSH kľúče vo vašom účte, potom pri vytváraní servera odošlite ich uuids ako ssh_key_uuids.GET zobrazí zoznam vašich kľúčov (25 na stránku); POST pridá jeden.

Požadované povolenie: ssh-keys:list (GET), ssh-keys:create (POST)

Parametre tela požiadavky (POST)

Parameter	Typ	Povinné	Opis
`name`	string	Áno	Názov, podľa ktorého sa kľúč rozpozná, až do 100 znakov
`public_key`	string	Áno	Verejný kľúč vo formáte OpenSSH, napríklad obsah súboru id_ed25519.pub

Príklad žiadosti

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

Príklad odpovede

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

Polia odpovede

Pole	Typ	Opis
`id`, `uuid`	integer, string	Identifikátory kľúčov. Použite uuid v ssh_key_uuids a v URL nižšie; id funguje v ssh_key_ids.
`fingerprint`	string	MD5 odtlačok kľúča, vypočítaný platformou
`last_used_at`	datetime \| null	Kedy bol kľúč naposledy nainštalovaný na novom serveri

Kódy stavu odpovede

201	Pridaný kľúč
400	Chýba meno, alebo verejný kľúč nie je platný verejný kľúč SSH

ZÍSKAŤ ODSTRÁNIŤ /api/v1/ssh-keys/{uuid}/

Získanie alebo zmazanie SSH kľúča

GET vráti jeden kľúč s vyššie uvedenými poľami. DELETE ho odstráni z vášho účtu a vráti 204 bez tela. Zmazanie kľúča ho neodstráni zo serverov, na ktorých už bol nainštalovaný. Kľúče nie je možné upravovať: zmazať a znova pridať.

Požadované povolenie: 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"

Zálohy a snapshoty

Vytvorenie zálohy alebo snímky je tiež serverová akcia:

POST /api/v1/servers/{uuid}/backup/: Zálohovacie API
POST /api/v1/servers/{uuid}/snapshot/: Rozhranie API pre snímky

VPS.org API

Zoznam všetkých serverov

Parametre dopytu

Príklad žiadosti

Príklad odpovede

Polia odpovede

Kódy stavu odpovede

Vytvoriť nový server

Parametre tela požiadavky

Príklad žiadosti

Príklad odpovede

Kódy stavu odpovede

Získať podrobnosti o serveri

Príklad odpovede

Polia odpovede

Kódy stavu odpovede

Získať stav servera

Hodnoty stavu servera

Ovládanie napájania servera

Parametre tela požiadavky

Príklad žiadosti

Príklad odpovede

Kódy stavu odpovede

Zmena veľkosti servera

Parametre tela požiadavky

Kódy stavu odpovede

Resetovať root heslo

Kódy stavu odpovede

Reverzný DNS (PTR)

Parametre tela požiadavky (POST)

Kódy stavu odpovede

Spustenie príkazu na serveri

Parametre tela požiadavky

Kódy stavu odpovede

Odstrániť server

Kódy stavu odpovede

SSH kľúče

Parametre tela požiadavky (POST)

Príklad žiadosti

Príklad odpovede

Polia odpovede

Kódy stavu odpovede

Získanie alebo zmazanie SSH kľúča

Zálohy a snapshoty