Szerverek API-ja

KAP /api/v1/servers/

Összes szerver listázása

Visszaadja a szervereket a fiókjában, a legújabbat, oldalonként 25-öt. A törölt szervereket nem tartalmazza.

Szükséges engedély: servers:list

Lekérdezési paraméterek

Paraméter	Típus	Kívánt	Leírás
`page`	integer	Nem.	Oldalszám, 1-től kezdődően
`page_size`	integer	Nem.	Az egyes oldalak eredményei (alapértelmezett 25, maximum 100)

Példa kérés

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

Példaválasz

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

Válaszmezők

Mező	Típus	Leírás
`uuid`	string	A kiszolgáló azonosítója minden más kiszolgáló végpontban
`hostname`	string	A kiszolgáló létrehozásakor választott név
`status`	string	Jelenlegi állapot. Lásd a szerver státusz értékeit alább.
`error_description`	string \| null	Az utolsó hiba részletei, ha a státusz hiba, egyébként semmi
`location_name`	string	Name of the location the server runs in
`os_name`	string	Üzemeltetési rendszer neve, verzió nélkül
`plan_name`	string	Olvasható terv összefoglaló, például 1 vCPU / 2 GB RAM / 10 GB
`ipv4_addresses`	array	IPv4 címek húrok. Üres, amíg a szerver telepítve, és tervek nélkül IPv4.
`ipv6_addresses`	array	IPv6 címek húrok. Üres, amíg a szerver telepítve.
`created_at`	datetime	Teremtési idő (ISO 8601, UTC)
`deployed`	boolean	Igaz, ha a rendelkezés befejeződött

Válasz állapotkódok

200	Szerverlista sikeresen lekérve
403	Hiányzó vagy érvénytelen API token, vagy a token hiányzik a szükséges engedély

HÓNAPPAL KÉSŐBB /api/v1/servers/

Új szerver létrehozása

A telepítéshez új szerverre tesz szert, és azonnal visszaadja a státuszsort. A szolgáltatás a háttérben folytatódik: az állapot végpontot addig kell keresni, amíg a telepítés igaz nem lesz. Amikor a szerver készen áll, a bejelentkezési adatait e-mailben küldjük el a számla tulajdonosának.

A számládnak szüksége van egy mentett fizetési módra. A számlaelőzményektől függően a szerver létrehozása előtt a terv árából körülbelül egy héttel (legalább 1 USD) ideiglenes elő-engedélyezési markolatot helyezhetünk el a kártyára.

Szükséges engedély: servers:create

Kérés törzsének paraméterei

Paraméter	Típus	Kívánt	Leírás
`hostname`	string	Igen	Legalább 3 karakter, betűk, számjegyek, kötőjelek és időszakok.
`location_id`	integer	Igen	Az azonosító egy aktív hely a helyszínek API
`plan_uuid`	string	Igen	Egy aktív terv uudja a tervekből API
`operating_system_version_uuid`	string	Igen	Az operációs rendszer verzióinak listájában szereplő aktív bejegyzés uudája
`ssh_key_uuids`	array	Nem.	UUID-ok SSH billentyűk az SSH Keys API telepíteni a szerverre
`ssh_key_ids`	array	Nem.	Az SSH billentyűk integer azonosítói, mint az ssh_key_uuids alternatívájaként. Ha mindkettőt elküldjük, akkor ssh_key_ids-t használunk.
`ssh_key_uuid`, `ssh_key_id`	string, integer	Nem.	Rövidírás egyetlen SSH kulcshoz
`auth_method`	string	Nem.	jelszó, ssh_key vagy mindkettő. A jelszó alapértelmezése, vagy mindkettő, ha SSH billentyűk vannak ellátva.

Példa kérés

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

Példaválasz

201 Created with the full server object described under Get Server Details. Addresses and vmid are filled in once deployment finishes.

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

Válasz állapotkódok

201	Kiszolgáló létrehozása és sorba áll a telepítéshez
400	Hitelesítési hiba, például inaktív hely, terv vagy operációs rendszer verziója
402	Nem csökkent a fájlban, a kifizetetlen számlákon vagy az előzetes engedélyen szereplő kártya fizetési módja
403	Hiányzó vagy érvénytelen API token, vagy a token hiányzik a szükséges engedély
429	A fiókja elérte a szerver létrehozása limitjét

KAP /api/v1/servers/{uuid}/

Szerveradatok lekérése

Visszaadja az egyik szervert a helyére, a tervbe, operációs rendszerébe, IP címébe és az öt legutóbbi műveletbe.

Szükséges engedély: servers:list

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

Példaválasz

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

Az SVG ikonfeljelölés és a verziók listája itt rövidül.

Válaszmezők

Mező	Típus	Leírás
`vmid`	integer \| null	A gép virtuális száma a telepítés során
`location`	object	Helymeghatározási objektum, a Helyszínek API által visszaküldött módon
`plan`	object	Terv objektum, ahogy a tervek API
`operating_system`, `operating_system_version`	object	Az operációs rendszer és a telepített verzió, az operációs rendszerek API által visszaküldött
`ipv4_addresses`, `ipv6_addresses`	array	Egy objektum címenként ip-tel, átjáróval, alhálózattal és rdns-sel (a fordított DNS hostname)
`recent_actions`	array	Akár öt utolsó akció: azonosító, action, action_display, leírás, felhasználó_email, created_at

Válasz állapotkódok

200	Szerveradatok lekérése sikeresen megtörtént
404	Nem található, vagy más számlához tartozik.

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

A kiszolgáló állapota

Könnyű szavazási felhívás egy szerver létrehozása, hatalom vagy átméretezése után.

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
}

A kiszolgáló állapotértékei

Érték	Leírás
`queue`	A művelet (kilövés, teljesítmény, átméretezés, helyreállítás) sorba áll vagy folyamatban van
`deploying`	A vezérlőpanelről létrehozott szerverek ezt az állapotot használják; az API-n keresztül létrehozott szerverek sorban maradnak, amíg készen nem állnak.
`on`	Futás
`off`	Kikapcsolva
`error`	Az utolsó művelet sikertelen. Lásd a hiba_leírást.
`suspended_payment`	Felfüggesztve a kifizetetlen számlák miatt

HÓNAPPAL KÉSŐBB /api/v1/servers/{uuid}/power/

A kiszolgáló teljesítménye

A kiszolgáló állapota addig változik, amíg a művelet be nem fejeződik.

Szükséges engedély: servers:power

Kérés törzsének paraméterei

Paraméter	Típus	Kívánt	Leírás
`action`	string	Igen	`start`: teljesítmény `shutdown`: elegáns leállás, kényszerleszállás, ha a vendég nem áll meg `restart`: kemény teljesítményciklus (megállás, majd indítás) `stop`: Jelenleg ugyanazt az energiaciklust végzi, mint az újraindítás. A leállítással kikapcsolhat egy szervert.

Példa kérés

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

Példaválasz

{
  "message": "Server restart queued"
}

Válasz állapotkódok

200	Az akció sorba állt.
400	Hiányzó vagy nem támogatott intézkedés
402	a számla kifizetetlen számlával való visszaélés miatt nem történt meg
404	Nem található, vagy más számlához tartozik.

HÓNAPPAL KÉSŐBB /api/v1/servers/{uuid}/resize/

Egy kiszolgáló átméretezése

A szerver egy másik aktív tervre költözik. Az új terv nem lehet kevesebb lemezterülettel, mint az aktuális, és a kérésnek tartalmaznia kell az átméretezésre beállított cselekvési tervet. Az új terv hipervizorkapacitását még a sorba állás előtt ellenőrzik, így a visszautasított kérés változatlanul hagyja a szervert.

A szerver le van kapcsolva, miközben átméretezik és utána újra elindul. Ha az átméretezés nem sikerül, a szerver visszakerül a korábbi tervébe, és újra elindul, ha fut. A lemeznövekedés nem lehet kikapcsolni.

Szükséges engedély: servers:resize

Kérés törzsének paraméterei

Paraméter	Típus	Kívánt	Leírás
`action`	string	Igen	Át kell nagyítani.
`new_plan_uuid`	string	Igen	A terv ujidja, hogy átköltözünk

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

Példa a visszautasított méretre (409):

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

Válasz állapotkódok

200	Az akció sorba állt.
400	Hiányzó művelet vagy új_plan_uuid, érvénytelen vagy inaktív terv, kevesebb lemezterületű terv vagy GPU terv (a GPU tervek nem méretezhetők át az API-n keresztül)
404	Nem található, vagy más számlához tartozik.
409	Az átméretezés vagy tárolás már folyamatban van, vagy nincs elegendő hipervizorkapacitás az új tervhez
503	A kapacitást jelenleg nem lehetett ellenőrizni. A szerver nem változott; később újra próbálkozni.

HÓNAPPAL KÉSŐBB /api/v1/servers/{uuid}/reset-password/

A gyökérjelszó visszaállítása

Új root jelszót generál, visszaadja a válaszban, és sorban áll a változás a szerveren. Az új jelszó is e-mailben elérhető. A kiszolgálót be kell vetni. Nincs szükség kérésre.

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

Válasz állapotkódok

200	Az akció sorba állt.
400	A szerver még nem telepítve
404	Nem található, vagy más számlához tartozik.

KAP HÓNAPPAL KÉSŐBB /api/v1/servers/{uuid}/rdns/

Fordított DNS (PTR)

GET felsorolja a fordított DNS-hostnevet minden IPv4 és IPv6 cím a szerveren. POST beállítja egy címet. Küld egy üres hostname újra beállítja a címet az alapértelmezett fordított DNS-név.

Szükséges engedély: servers:update

Kérés törzsének paraméterei (POST)

Paraméter	Típus	Kívánt	Leírás
`ip`	string	Igen	A kiszolgálóhoz rendelt IPv4 vagy IPv6 cím
`hostname`	string	Nem.	A PTR hostname. Hagyja üresen az alapértelmezett beállítást.

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

Válaszolj!

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

Válasz állapotkódok

400	ip hiányzik, vagy a hostname nem állítható
404	Az IP-cím nem kerül a kiszolgálóra

HÓNAPPAL KÉSŐBB /api/v1/servers/{uuid}/exec/

Parancs futtatása egy kiszolgálón

A QEMU vendégügynökön keresztül shell parancsot futtat a szerveren belül, és várja, hogy befejezze. A szervert ki kell vetni és futtatni kell, és a qemu-vendégügynököt telepíteni kell és futtatni kell a vendégben.

Szükséges engedély: servers:exec

Kérés törzsének paraméterei

Paraméter	Típus	Kívánt	Leírás
`command`	string	Igen	Parancssor futtatása /bin/sh -c karakterekkel, 2000 karakterig
`timeout`	integer	Nem.	Másodpercek a parancsra, 1-300 (alapértelmezett 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
}

Ha a parancs még mindig fut, amikor az időkimaradás lejár, a válasz időd_out-ban van beállítva a valós és exit_code-ban.

Válasz állapotkódok

200	Parancs befejezve vagy időzítve
400	A kiszolgáló nem telepítve vagy nem futtatható, vagy érvénytelen paraméterek
409	A QEMU vendégügynöke nem fut a szerveren
503	Temporary connection problem. Retry after the Retry-After header.

TÖRÖL /api/v1/servers/{uuid}/

Szerver törlése

A szerver állandó törlésre keresi a kiszolgálót. A szerver azonnal eltűnik a listáról, és nem lehet visszaszerezni.

Szükséges engedély: 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"
}

Válasz állapotkódok

202	Elfogadva: a kérés sorba állt
404	Nem található, vagy más számlához tartozik.

KAP HÓNAPPAL KÉSŐBB /api/v1/ssh-keys/

SSH kulcsok

Tárolja nyilvános SSH kulcsokat a fiókjában, majd adja át az uuids ssh_key_uuids amikor létrehoz egy szervert. GET listázza a kulcsokat (25 oldalonként); POST hozzá egy.

Szükséges engedély: ssh-keys:list (GET), ssh-keys:create (POST)

Kérés törzsének paraméterei (POST)

Paraméter	Típus	Kívánt	Leírás
`name`	string	Igen	A kulcsot legfeljebb 100 karakterrel lehet felismerni
`public_key`	string	Igen	A nyilvános kulcs OpenSSH formátumban, például az id_ed25519.pub tartalma

Példa kérés

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

Példaválasz

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

Válaszmezők

Mező	Típus	Leírás
`id`, `uuid`	integer, string	Kulcsazonosítók. Uuid használata ssh_key_uuids-ben és az alábbi URL-ben; az azonosító ssh_key_ids-ben működik.
`fingerprint`	string	A kulcs MD5 ujjlenyomata, amelyet a platform számít ki
`last_used_at`	datetime \| null	Amikor a kulcs utoljára egy új szerverre lett telepítve

Válasz állapotkódok

201	Kulcs hozzáadva
400	Hiányzó név vagy a nyilvános kulcs nem érvényes SSH nyilvános kulcs

KAP TÖRÖL /api/v1/ssh-keys/{uuid}/

SSH kulcs letöltése vagy törlése

GET visszatér egy kulcsot a fenti mezők. DELETE eltávolítja a fiókjából, és 204-et ad vissza test nélkül. A kulcs törlése nem távolítja el a már telepített szerverekből. A kulcsok nem szerkeszthetők: töröljük és adjunk hozzá újra.

Szükséges engedély: 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"

Háttérképek és fotók

A biztonsági mentés vagy pillanatfelvétel létrehozása szintén szerver akció:

POST /api/v1/servers/{uuid}/backup/: Biztonsági mentések API
POST /api/v1/servers/{uuid}/snapshot/: Pillanatképek API

VPS.org API

Szerverek API-ja

Összes szerver listázása

Lekérdezési paraméterek

Példa kérés

Példaválasz

Válaszmezők

Válasz állapotkódok

Új szerver létrehozása

Kérés törzsének paraméterei

Példa kérés

Példaválasz

Válasz állapotkódok

Szerveradatok lekérése

Példaválasz

Válaszmezők

Válasz állapotkódok

A kiszolgáló állapota

A kiszolgáló állapotértékei

A kiszolgáló teljesítménye

Kérés törzsének paraméterei

Példa kérés

Példaválasz

Válasz állapotkódok

Egy kiszolgáló átméretezése

Kérés törzsének paraméterei

Válasz állapotkódok

A gyökérjelszó visszaállítása

Válasz állapotkódok

Fordított DNS (PTR)

Kérés törzsének paraméterei (POST)

Válasz állapotkódok

Parancs futtatása egy kiszolgálón

Kérés törzsének paraméterei

Válasz állapotkódok

Szerver törlése

Válasz állapotkódok

SSH kulcsok

Kérés törzsének paraméterei (POST)

Példa kérés

Példaválasz

Válaszmezők

Válasz állapotkódok

SSH kulcs letöltése vagy törlése

Háttérképek és fotók