API tas-Servers

IKSEB /api/v1/servers/

Elenka s-Servers Kollha

Jirritorna l-servers fil-kont tiegħek, l-aktar ġdida ewwel, 25 għal kull paġna.Servers li qed jitħassru mhumiex inklużi.

Permess meħtieġ: servers:list

Parametri tal-Mistoqsija

Parametru	Tip	Meħtieġ	Deskrizzjoni
`page`	integer	Nru	Numru tal-paġna, li jibda minn 1
`page_size`	integer	Nru	Riżultati għal kull paġna (default 25, massimu 100)

Eżempju ta' Talba

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

Eżempju ta' Rispons

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

Oqsma ta' Rispons

Qasam	Tip	Deskrizzjoni
`uuid`	string	Identifikatur tas-server użat f’kull punt aħħari tas-server ieħor
`hostname`	string	Hostname inti għażilt meta toħloq is-server
`status`	string	Ara Valuri Status Server hawn taħt.
`error_description`	string \| null	Dettalji tal-aħħar falliment meta l-istatus ikun żball, inkella null
`location_name`	string	Isem tal-post fejn jaħdem is-server
`os_name`	string	Isem is-sistema operattiva, mingħajr il-verżjoni
`plan_name`	string	Sommarju tal-pjan li jinqara, pereżempju 1 vCPU / 2 GB RAM / 10 GB
`ipv4_addresses`	array	Indirizzi IPv4 bħala strings. vojta sakemm is-server huwa skjerat, u fuq il-pjanijiet mingħajr IPv4.
`ipv6_addresses`	array	Indirizzi IPv6 bħala strings. vojta sakemm is-server huwa skjerat.
`created_at`	datetime	Ħin tal-ħolqien (ISO 8601, UTC)
`deployed`	boolean	Veru ladarba l-provvista tkun spiċċat

Kodiċijiet tal-Istatus tar-Rispons

200	Lista tas-servers irkuprata b'suċċess
403	Token tal-API nieqes jew invalidu, jew it-token ma għandux il-permess meħtieġ

POST /api/v1/servers/

Oħloq Server Ġdid

Kju server ġdid għall-iskjerament u jirritorna minnufih mal-kwiekeb status. Provisioning tkompli fl-isfond: poll-punt aħħari status sakemm skjerati huwa veru. Meta s-server huwa lest, id-dettalji login tagħha huma emailed lill-sid tal-kont.

Il-kont tiegħek jeħtieġ metodu ta' ħlas salvat.Skond l-istorja tal-kont tiegħek, jista' jkun hemm żamma ta' preawtorizzazzjoni temporanja ta' madwar ġimgħa tal-prezz tal-pjan (mill-inqas USD 1) fuq il-karta tiegħek qabel ma jinħoloq is-server.

Permess meħtieġ: servers:create

Parametri tal-Korp tat-Talba

Parametru	Tip	Meħtieġ	Deskrizzjoni
`hostname`	string	Iva	Mill-inqas 3 karattri. Ittri, numri, ħosna u punti biss.
`location_id`	integer	Iva	L-ID ta’ post attiv mill-API tal-Postijiet
`plan_uuid`	string	Iva	L-uuid ta’ pjan attiv mill-API tal-Pjanijiet
`operating_system_version_uuid`	string	Iva	L-uuid ta' entrata attiva fil-lista tal-verżjonijiet ta' sistema operattiva
`ssh_key_uuids`	array	Nru	UUIDs ta’ ċwievet SSH mill-API ta’ SSH Keys li għandhom jiġu installati fuq is-server
`ssh_key_ids`	array	Nru	Id-dettalji tal-IDs tal-keys SSH, bħala alternattiva għal ssh_key_uuids. Jekk it-tnejn jintbagħtu, jintuża ssh_key_ids.
`ssh_key_uuid`, `ssh_key_id`	string, integer	Nru	Shorthand għal ċavetta SSH waħda
`auth_method`	string	Nru	password, ssh_key jew it-tnejn. defaults għall-password, jew għat-tnejn meta ċwievet SSH huma pprovduti.

Eżempju ta' Talba

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

Eżempju ta' Rispons

201 Maħluqa bl-oġġett server sħiħ deskritt taħt Get Server Dettalji. Indirizzi u vmid huma mimlija fil darba l-iskjerament jispiċċa.

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

Kodiċijiet tal-Istatus tar-Rispons

201	Server maħluqa u fil-kju għall-iskjerament
400	Żball ta’ validazzjoni, pereżempju lokazzjoni inattiva, pjan jew verżjoni tas-sistema operattiva
402	L-ebda metodu ta' ħlas fil-fajl, fatturi mhux imħallsa, jew il-pre-awtorizzazzjoni tal-kard ġiet irrifjutata
403	Token tal-API nieqes jew invalidu, jew it-token ma għandux il-permess meħtieġ
429	Il-kont tiegħek laħaq il-limitu tal-ħolqien tas-server

IKSEB /api/v1/servers/{uuid}/

Ikseb id-Dettalji tas-Server

Jirritorna server wieħed bil-post tiegħu, pjan, sistema operattiva, indirizzi IP u l-ħames azzjonijiet aktar reċenti.

Permess meħtieġ: servers:list

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

Eżempju ta' Rispons

{
  "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 icon markup u l-lista tal-verżjonijiet huma mqassra hawnhekk.

Oqsma ta' Rispons

Qasam	Tip	Deskrizzjoni
`vmid`	integer \| null	Numru tal-magna virtwali, stabbilit matul l-iskjerament
`location`	object	Oġġett tal-lokazzjoni, kif irritornat mill-API tal-Lokazzjonijiet
`plan`	object	Oġġett tal-pjan, kif irritornat mill-API tal-Pjanijiet
`operating_system`, `operating_system_version`	object	Sistema operattiva u l-verżjoni installata, kif ir-ritorn mill-API tas-Sistemi Operattivi
`ipv4_addresses`, `ipv6_addresses`	array	Oġġett wieħed għal kull indirizz bl-ip, gateway, subnet u rdns (l-hostname DNS inversa)
`recent_actions`	array	Sa ħames azzjonijiet l-aktar reċenti: id, action, action_display, deskrizzjoni, user_email, created_at

Kodiċijiet tal-Istatus tar-Rispons

200	Id-dettalji tas-server inġabru b'suċċess
404	Ma nstabx, jew jappartjeni għal kont ieħor

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

Ikseb l-istatus tas-server

A sejħa ħfief għall-istħarriġ wara li toħloq, qawwa jew tibdel id-daqs server.

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
}

Valuri tal-Istatus tas-Server

Valur	Deskrizzjoni
`queue`	Azzjoni (tqassim, qawwa, tibdel id-daqs, tirrestawra) hija fil-kju jew għaddejja
`deploying`	Servers maħluqa mill-pannell tal-kontroll jużaw dan l-istat; servers maħluqa permezz tal-API jibqgħu fil-kju sakemm ikunu lesti.
`on`	Tħaddim
`off`	Mitfi
`error`	L-aħħar azzjoni ma rnexxietx. Ara error_description.
`suspended_payment`	Sospiżi minħabba fatturi mhux imħallsa

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

Kontroll Server qawwa

Kjuijiet azzjoni enerġija. L-istatus server bidliet biex kju sakemm l-azzjoni tlesti.

Permess meħtieġ: servers:power

Parametri tal-Korp tat-Talba

Parametru	Tip	Meħtieġ	Deskrizzjoni
`action`	string	Iva	`start`: qawwa fuq `shutdown`: shutdown graceful, sfurzat off jekk il-mistieden ma tieqafx `restart`: ċiklu tal-qawwa qawwija (waqqaf, imbagħad ibda) `stop`: bħalissa twettaq l-istess ċiklu tal-enerġija bħal restart. Uża shutdown biex tħalli server off.

Eżempju ta' Talba

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

Eżempju ta' Rispons

{
  "message": "Server restart queued"
}

Kodiċijiet tal-Istatus tar-Rispons

200	L-azzjoni kienet fil-kju
400	Azzjoni nieqsa jew mhux appoġġata
402	bidu rrifjutat minħabba li l-kont għandu fatturi mhux imħallsa
404	Ma nstabx, jew jappartjeni għal kont ieħor

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

Ibdel id-daqs ta' Server

Imexxi s-server għal pjan attiv ieħor. Il-pjan il-ġdid ma jistax ikollu spazju disk inqas minn dak kurrenti, u l-korp tal-talba għandu jinkludi azzjoni stabbilita biex tibdel id-daqs. Kapaċità Hypervisor għall-pjan il-ġdid huwa ċċekkjat qabel xi ħaġa hija fil-kju, sabiex talba rrifjutata tħalli s-server mhux mibdula.

Is-server huwa mitfi waqt li huwa daqsijiet u reboot wara. Jekk id-daqsijiet jerġgħu jonqsu, is-server huwa mqiegħda lura fuq il-pjan preċedenti tiegħu u reboot jekk kien qed jaħdem. Disk tkabbir ma jistgħux jiġu rtirati.

Permess meħtieġ: servers:resize

Parametri tal-Korp tat-Talba

Parametru	Tip	Meħtieġ	Deskrizzjoni
`action`	string	Iva	Għandu jkun risize
`new_plan_uuid`	string	Iva	L-uuid tal-pjan li għandu jiġi trasferit

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

Eżempju ta' ridimensjoni rrifjutata (409):

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

Kodiċijiet tal-Istatus tar-Rispons

200	L-azzjoni kienet fil-kju
400	Azzjoni nieqsa jew new_plan_uuid, pjan invalidu jew inattiv, pjan b'inqas spazju fuq id-diska, jew pjan GPU (pjanijiet GPU ma jistgħux jiġu aġġustati permezz tal-API)
404	Ma nstabx, jew jappartjeni għal kont ieħor
409	Bidla fid-daqs jew fil-ħażna hija diġà għaddejja, jew m’hemmx biżżejjed kapaċità hypervisor għall-pjan il-ġdid
503	Il-kapaċità ma setgħetx tiġi ċċekkjata bħalissa. Is-server ma nbidilx; ipprova mill-ġdid aktar tard.

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

Irrisettja l-Password Root

Jiġġenera password ġdida tal- root, jerġa' jirritornaha fit-tweġiba u jqiegħed il-bidla fil-kju fuq is-server. Il-password il-ġdida tintbagħatlek ukoll bl-email. Is-server għandu jkun imħaddem. M'hemmx bżonn ta' korp ta' talba.

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

Kodiċijiet tal-Istatus tar-Rispons

200	L-azzjoni kienet fil-kju
400	Is-server għadu ma ġiex skjerat
404	Ma nstabx, jew jappartjeni għal kont ieħor

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

DNS inversa (PTR)

GET telenka l-hostname DNS reverse ta' kull indirizz IPv4 u IPv6 fuq is-server. POST tistabbilixxi dan għal indirizz wieħed. Li tibgħat hostname vojta tirrisettja l-indirizz għall-isem DNS reverse default tiegħu.

Permess meħtieġ: servers:update

Parametri tal-Korp tat-Talba (POST)

Parametru	Tip	Meħtieġ	Deskrizzjoni
`ip`	string	Iva	Indirizz IPv4 jew IPv6 assenjat lil dan is-server
`hostname`	string	Nru	L-isem tal-host tal-PTR. Ħalli vojt biex terġa' tissettja għall-predefinit.

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

Rispons GET:

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

Kodiċijiet tal-Istatus tar-Rispons

400	ip nieqsa, jew il-hostname ma setgħetx tiġi stabbilita
404	L-indirizz IP mhuwiex assenjat għal dan is-server

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

Mexxi Kmand fuq Server

Tħaddem kmand tal-qoxra ġewwa s-server permezz tal-aġent tal-mistieden QEMU u tistenna li dan jintemm. Is-server għandu jkun imħaddem u qed jaħdem, u qemu-guest-agent għandu jkun installat u qed jaħdem fil-mistieden.

Permess meħtieġ: servers:exec

Parametri tal-Korp tat-Talba

Parametru	Tip	Meħtieġ	Deskrizzjoni
`command`	string	Iva	Linja tal-kmand tmexxija ma /bin/sh -c, sa 2000 karattru
`timeout`	integer	Nru	Sekondi biex tistenna għall-kmand, 1 sa 300 (default 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
}

Jekk il-kmand għadu għaddej meta l-timeout jiskadi, ir-rispons għandha timed_out stabbiliti għal veru u exit_code stabbiliti għal null.

Kodiċijiet tal-Istatus tar-Rispons

200	Kmand lest jew timeout
400	Server mhux imħaddem jew mhux qed jaħdem, jew parametri invalidi
409	L-aġent tal-mistednin QEMU mhuwiex qed jaħdem fuq is-server
503	Problema temporanja konnessjoni. Ipprova mill-ġdid wara l-Retry-After header.

ĦASSAR /api/v1/servers/{uuid}/

Ħassar is-Server

Il-kju tas-server għat-tħassir permanenti. Is-server jisparixxi mil-lista immedjatament u ma jistax jiġi rkuprat.

Permess meħtieġ: 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"
}

Kodiċijiet tal-Istatus tar-Rispons

202	Aċċettat: it-talba ġiet imqiegħda fil-kju
404	Ma nstabx, jew jappartjeni għal kont ieħor

IKSEB POST /api/v1/ssh-keys/

Ċwievet SSH

Ħażna ċwievet pubbliċi SSH fil-kont tiegħek, imbagħad jgħaddu uuids tagħhom bħala ssh_key_uuids meta toħloq server. GET lista ċwievet tiegħek (25 kull paġna); POST żżid wieħed.

Permess meħtieġ: ssh-keys:list (GET), ssh-keys:create (POST)

Parametri tal-Korp tat-Talba (POST)

Parametru	Tip	Meħtieġ	Deskrizzjoni
`name`	string	Iva	Isem biex tirrikonoxxi l-muftieħ, sa 100 karattru
`public_key`	string	Iva	Iċ-ċavetta pubblika f'format OpenSSH, pereżempju l-kontenut ta' id_ed25519.pub

Eżempju ta' Talba

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

Eżempju ta' Rispons

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

Oqsma ta' Rispons

Qasam	Tip	Deskrizzjoni
`id`, `uuid`	integer, string	Uża l-uuid f'ssh_key_uuids u fl-URL t'hawn taħt; id jaħdem f'ssh_key_ids.
`fingerprint`	string	Il-marka tal-idejn MD5 taċ-ċavetta, ikkalkulata mill-pjattaforma
`last_used_at`	datetime \| null	Meta l-muftieħ kien installat l-aħħar fuq server ġdid

Kodiċijiet tal-Istatus tar-Rispons

201	Key miżjud
400	Isem nieqes, jew iċ-ċavetta pubblika mhijiex valida ċavetta pubblika SSH

IKSEB ĦASSAR /api/v1/ssh-keys/{uuid}/

Ikseb jew Ħassar SSH Key

GET tirritorna waħda ewlenija mal-oqsma hawn fuq. DELETE tneħħi mill-kont tiegħek u tirritorna 204 mingħajr korp. Ħassar ewlenija ma tneħħi minn servers kien diġà installat fuq. Keys ma jistgħux jiġu editjati: tħassar u żid mill-ġdid.

Permess meħtieġ: 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"

Backups u Snapshots

Il-ħolqien ta’ backup jew snapshot huwa wkoll azzjoni tas-server:

POST /api/v1/servers/{uuid}/backup/: API tal-Backups
POST /api/v1/servers/{uuid}/snapshot/: API tal-Snapshots

VPS.org API

API tas-Servers

Elenka s-Servers Kollha

Parametri tal-Mistoqsija

Eżempju ta' Talba

Eżempju ta' Rispons

Oqsma ta' Rispons

Kodiċijiet tal-Istatus tar-Rispons

Oħloq Server Ġdid

Parametri tal-Korp tat-Talba

Eżempju ta' Talba

Eżempju ta' Rispons

Kodiċijiet tal-Istatus tar-Rispons

Ikseb id-Dettalji tas-Server

Eżempju ta' Rispons

Oqsma ta' Rispons

Kodiċijiet tal-Istatus tar-Rispons

Ikseb l-istatus tas-server

Valuri tal-Istatus tas-Server

Kontroll Server qawwa

Parametri tal-Korp tat-Talba

Eżempju ta' Talba

Eżempju ta' Rispons

Kodiċijiet tal-Istatus tar-Rispons

Ibdel id-daqs ta' Server

Parametri tal-Korp tat-Talba

Kodiċijiet tal-Istatus tar-Rispons

Irrisettja l-Password Root

Kodiċijiet tal-Istatus tar-Rispons

DNS inversa (PTR)

Parametri tal-Korp tat-Talba (POST)

Kodiċijiet tal-Istatus tar-Rispons

Mexxi Kmand fuq Server

Parametri tal-Korp tat-Talba

Kodiċijiet tal-Istatus tar-Rispons

Ħassar is-Server

Kodiċijiet tal-Istatus tar-Rispons

Ċwievet SSH

Parametri tal-Korp tat-Talba (POST)

Eżempju ta' Talba

Eżempju ta' Rispons

Oqsma ta' Rispons

Kodiċijiet tal-Istatus tar-Rispons

Ikseb jew Ħassar SSH Key

Backups u Snapshots