API poslužitelja

DOBITI /api/v1/servers/

Popis svih poslužitelja

Vraća poslužitelje na vašem računu, najnoviji, 25 po stranici. Poslužitelji koji se brišu nisu uključeni.

Potrebna dozvola: servers:list

Parametri upita

Parametri	Tip	Potreban	Opis
`page`	integer	Ne.	Broj stranice, počevši od 1
`page_size`	integer	Ne.	Rezultati po stranici (zadano 25, maksimalno 100)

Primjer zahtjeva

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

Primjer odgovora

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

Polja za odgovor

Polje	Tip	Opis
`uuid`	string	Poslužiteljski identifikator koji se koristi u svakom drugom ishodnom ishodu poslužitelja
`hostname`	string	Ime računara koje ste odabrali pri stvaranju poslužitelja
`status`	string	Trenutno stanje. Pogledajte vrijednosti Statusa poslužitelja ispod.
`error_description`	string \| null	Detalji zadnjeg neuspjeha kada je status greška, inače null
`location_name`	string	Ime lokacije u kojoj poslužitelj pokreće
`os_name`	string	Ime operacijskog sustava, bez inačice
`plan_name`	string	Sažetak plana za čitanje, na primjer 1 vCPU / 2 GB RAM / 10 GB
`ipv4_addresses`	array	IPv4 adrese kao stringovi. Prazno dok se poslužitelj ne pokrene, i na planovima bez IPv4.
`ipv6_addresses`	array	IPv6 adrese kao nizove. Prazno dok se poslužitelj ne aktivira.
`created_at`	datetime	Vrijeme stvaranja (ISO 8601, UTC)
`deployed`	boolean	Istina je kada se opskrba završi

Kodovi statusa odgovora

200	Popis poslužitelja uspješno dohvaćen
403	Nedostaje ili neispravan API žeton, ili token nedostaje potrebna dozvola

POST /api/v1/servers/

Stvori novi poslužitelj

U redu novi poslužitelj za raspoređivanje i vraća ga odmah sa statusom reda. Provizija se nastavlja u pozadini: anketa statusa ishoda dok se ne aktivira. Kada je poslužitelj spreman, njegov podaci za prijavu su e-pošte vlasniku računa.

Vaš račun treba ušteđenu metodu plaćanja. Ovisno o povijesti vašeg računa, privremeno pre-autoriziranje drži oko tjedan dana od cijene plana (najmanje 1 USD) može biti postavljeno na vašu karticu prije nego što se server stvori.

Potrebna dozvola: servers:create

Zahtjev za parametre tijela

Parametri	Tip	Potreban	Opis
`hostname`	string	Da	Najmanje 3 znakova. slova, brojke, crtane i samo periode.
`location_id`	integer	Da	Id aktivne lokacije iz API lokacije
`plan_uuid`	string	Da	Uuid aktivnog plana iz plana API
`operating_system_version_uuid`	string	Da	Uuid aktivnog unosa u popisu verzija operativnog sustava
`ssh_key_uuids`	array	Ne.	UUIDovi SSH ključeva iz SSH tipke API za instalaciju na poslužitelju
`ssh_key_ids`	array	Ne.	Cijeli broj SSH tipki, kao alternativa ssh_key_uuids. Ako su oba poslana, ssh_key_ids se koristi.
`ssh_key_uuid`, `ssh_key_id`	string, integer	Ne.	Kratka ruka za jedan SSH ključ
`auth_method`	string	Ne.	lozinka, ssh_ key ili oboje. Podrazumijeva se na lozinku ili na oba kada su dostavljene SSH tipke.

Primjer zahtjeva

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

Primjer odgovora

201 Stvoren s punim objektom servera opisanim u Get Detalji poslužitelja. Adresa i vmid su popunjeni u jednom razmještanju završetka.

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

Kodovi statusa odgovora

201	Poslužitelj je stvoren i u redu za raspoređivanje
400	Pogreška pri provjeri, na primjer neaktivna lokacija, plan ili verzija operativnog sustava
402	Nije odbijen način plaćanja na datoteci, neplaćene račune ili predovlaštenje kartice
403	Nedostaje ili neispravan API žeton, ili token nedostaje potrebna dozvola
429	Vaš korisnički račun je dostigao ograničenje stvaranja poslužitelja

DOBITI /api/v1/servers/{uuid}/

Detalji o poslužitelju

Vraća jedan poslužitelj sa svojim lokacijom, planom, operativnim sustavom, IP adresama i pet najnovijih akcija.

Potrebna dozvola: servers:list

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

Primjer odgovora

{
  "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 označavanje ikona i popis verzija se skraćuju ovdje.

Polja za odgovor

Polje	Tip	Opis
`vmid`	integer \| null	Broj virtualne mašine, postavljena tijekom raspoređivanja
`location`	object	Objekt lokacije, kao što je vratio lokacije API
`plan`	object	Plan objekt, kao što je vraćen od plana API
`operating_system`, `operating_system_version`	object	Operativni sustav i instalirana verzija, kao što je vratio API Operativni sustavi
`ipv4_addresses`, `ipv6_addresses`	array	Jedan objekt po adresi s iP, bravom, podmrežom i rdns (obrni DNS ime računala)
`recent_actions`	array	Do pet najnovijih akcija: id, akcija, action_display, opis, user_email, created_at

Kodovi statusa odgovora

200	Uspješno preuzeti podaci o poslužitelju
404	Nije pronađeno, ili pripada drugom računu

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

Preuzmi status poslužitelja

Lagan poziv za anketu nakon što stvorite, moć ili mijenjanje veličine poslužitelja.

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
}

Vrijednosti stanja poslužitelja

Vrijednost	Opis
`queue`	Akcija (pokreni, pokreni, promijeni veličinu, vrati) je u redu ili u tijeku
`deploying`	Budući opskrba. Poslužitelji stvoreni iz kontrolne ploče koriste ovaj stav; poslužitelji stvoreni kroz API ostati u redu dok su spremni.
`on`	Pokrećem
`off`	Isključeno
`error`	Zadnja akcija nije uspjela. Pogledajte opis greške.
`suspended_payment`	Suspendirani zbog neplaćenih računa

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

Kontrolni poslužitelj

U redom je radnja struje. Status poslužitelja mijenja se u red dok se akcija ne završi.

Potrebna dozvola: servers:power

Zahtjev za parametre tijela

Parametri	Tip	Potreban	Opis
`action`	string	Da	`start`: napajanje `shutdown`: graciozno gašenje, odbačeno ako gost ne prestane `restart`: snažna energija (prestani, zatim pokreni) `stop`: Trenutno obavlja isti ciklus napajanja kao i ponovno pokrenuti. Koristite gašenje da ostavite isključen poslužitelj.

Primjer zahtjeva

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

Primjer odgovora

{
  "message": "Server restart queued"
}

Kodovi statusa odgovora

200	Akcija je u redu
400	Nedostajuća ili nepodržana akcija
402	početak odbijeno jer račun ima neplaćene račune
404	Nije pronađeno, ili pripada drugom računu

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

Promijeni veličinu poslužitelja

Premješta poslužitelj na drugi aktivni plan. Novi plan ne može imati manje prostora na disku od trenutnog, a tijelo zatraži mora uključivati akciju postavljenu za promjenu veličine. Postupak Hypervisora za novi plan se provjerava prije nego što se nešto u redu, pa odbijeni zahtjev ostavlja poslužitelj neizmijenjen.

Poslužitelj je ugašen dok se mijenja i ponovo pokreće nakon toga. Ako promjena ne uspije, poslužitelj se vraća na prethodni plan i ponovo pokreće ako je pokrenut. Rast diska se ne može poništiti.

Potrebna dozvola: servers:resize

Zahtjev za parametre tijela

Parametri	Tip	Potreban	Opis
`action`	string	Da	Mora biti veličina
`new_plan_uuid`	string	Da	Uuid plana za prelazak na

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

Primjer odbijene promjene veličine (409):

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

Kodovi statusa odgovora

200	Akcija je u redu
400	Nedostajuća akcija ili novi_plan_uuid, neispravan ili neaktivan plan, plan s manje prostora na disku ili GPU plan (GPU planovi se ne mogu mijenjati kroz API)
404	Nije pronađeno, ili pripada drugom računu
409	Promjena veličine ili spremišta već je u toku ili nema dovoljno kapaciteta hipervizora za novi plan
503	Poslužitelj nije promijenjen; ponovno ponavljam kasnije.

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

Ponovi korijensku zaporku

Generira novu root lozinku, vraća je u odgovoru i redovi promjene na poslužitelju. Nova lozinka vam je također poslana e- pošta. Poslužitelj mora biti pokrenut. Nije potrebno zatražiti tijelo.

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

Kodovi statusa odgovora

200	Akcija je u redu
400	Poslužitelj još nije aktiviran
404	Nije pronađeno, ili pripada drugom računu

DOBITI POST /api/v1/servers/{uuid}/rdns/

Obrni DNS (PTR)

GET lista obrnutog DNS naziva imena računala svake IPv4 i IPv6 adrese na poslužitelju. POST ga postavlja za jednu adresu. Slanje praznog naziva naziva resetuje adresu na zadano DNS ime.

Potrebna dozvola: servers:update

Zahtjev za parametre tijela (POST)

Parametri	Tip	Potreban	Opis
`ip`	string	Da	IPv4 ili IPv6 adresa dodijeljena ovom poslužitelju
`hostname`	string	Ne.	Ime računala PTR. Ostavi prazno da bi se resetovalo na uobičajeno.

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

Odgovor na dobijanje:

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

Kodovi statusa odgovora

400	IP nedostaje ili ime računara nije moguće postaviti
404	IP adresa nije dodijeljena ovom poslužitelju

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

Pokreni naredbu na poslužitelju

Pokreće ljuska naredbu unutar poslužitelja preko QEMU gost agenta i čeka da završi. Poslužitelj mora biti raspoređen i pokrenut, a qemu-guest-agent mora biti instaliran i radi u gostu.

Potrebna dozvola: servers:exec

Zahtjev za parametre tijela

Parametri	Tip	Potreban	Opis
`command`	string	Da	Naredbena linija pokreće sa /bin/sh - c, do 2000 znakova
`timeout`	integer	Ne.	Sekunde za čekanje naredbe, 1 do 300 (podrazumijevano 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
}

Ako je naredba još uvijek pokrenuta kada isteče vrijeme, odgovor je vremenski postavljen na true i exit_code postavljen na null.

Kodovi statusa odgovora

200	Naredba je završena ili je isteklo vrijeme
400	Poslužitelj nije pokrenut ili nije pokrenut, ili neispravni parametri
409	QEMU gost agent ne radi na poslužitelju
503	Problem privremene veze. Ponovite nakon zaglavlja Ponovno-After.

IZBRISATI /api/v1/servers/{uuid}/

Izbriši poslužitelj

Poslužitelj odmah nestaje s popisa i ne može se vratiti.

Potrebna dozvola: 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"
}

Kodovi statusa odgovora

202	Prihvaćeno: zahtjev je u redu
404	Nije pronađeno, ili pripada drugom računu

DOBITI POST /api/v1/ssh-keys/

SSH tipke

Pohranite javne SSH ključeve u svoj račun, zatim proslijedite njihove uuidove kao ssh_key_uuidove kada kreirate poslužitelj. Get liste svojih tipki (25 po stranici); POST dodaje jedan.

Potrebna dozvola: ssh-keys:list (GET), ssh-keys:create (POST)

Zahtjev za parametre tijela (POST)

Parametri	Tip	Potreban	Opis
`name`	string	Da	Ime za prepoznavanje ključa, do 100 znakova
`public_key`	string	Da	Javni ključ u OpenSSH formatu, na primjer sadržaj id_ed25519.pub

Primjer zahtjeva

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

Primjer odgovora

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

Polja za odgovor

Polje	Tip	Opis
`id`, `uuid`	integer, string	Identifikatori ključeva. Koristite uuid u ssh_key_uuids i u URL-u ispod; id radi u ssh_key_ids.
`fingerprint`	string	MD5 otisak ključa, izračunana platformom
`last_used_at`	datetime \| null	Kada je ključ zadnji put instaliran na novom poslužitelju

Kodovi statusa odgovora

201	Tipka dodana
400	Nedostaje ime ili javni ključ nije valjan SSH javni ključ

DOBITI IZBRISATI /api/v1/ssh-keys/{uuid}/

Dobavi ili obriši SSH ključ

Vraća jedan ključ s poljima iznad. DELETE ga uklanja s vašeg računa i vraća 204 bez tijela. Brisanje ključa ga ne uklanja s poslužitelja na kojem je već instaliran. Tipke se ne mogu uređivati: brisanje i dodavanje ponovno.

Potrebna dozvola: 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"

Pojačanja i snimke

Stvaranje sigurnosne kopije ili snimke je također i radnja poslužitelja:

POST /api/v1/servers/{uuid}/backup/: API za sigurnosne kopije
POST /api/v1/servers/{uuid}/snapshot/: API za snimke

VPS.org API

API poslužitelja

Popis svih poslužitelja

Parametri upita

Primjer zahtjeva

Primjer odgovora

Polja za odgovor

Kodovi statusa odgovora

Stvori novi poslužitelj

Zahtjev za parametre tijela

Primjer zahtjeva

Primjer odgovora

Kodovi statusa odgovora

Detalji o poslužitelju

Primjer odgovora

Polja za odgovor

Kodovi statusa odgovora

Preuzmi status poslužitelja

Vrijednosti stanja poslužitelja

Kontrolni poslužitelj

Zahtjev za parametre tijela

Primjer zahtjeva

Primjer odgovora

Kodovi statusa odgovora

Promijeni veličinu poslužitelja

Zahtjev za parametre tijela

Kodovi statusa odgovora

Ponovi korijensku zaporku

Kodovi statusa odgovora

Obrni DNS (PTR)

Zahtjev za parametre tijela (POST)

Kodovi statusa odgovora

Pokreni naredbu na poslužitelju

Zahtjev za parametre tijela

Kodovi statusa odgovora

Izbriši poslužitelj

Kodovi statusa odgovora

SSH tipke

Zahtjev za parametre tijela (POST)

Primjer zahtjeva

Primjer odgovora

Polja za odgovor

Kodovi statusa odgovora

Dobavi ili obriši SSH ključ

Pojačanja i snimke