Server-yada API

HEL /api/v1/servers/

Liis garee Dhammaan Adeegayaasha

Ku soo laabtay servers in aad xisaabta, ugu dambeeyay ee hore, 25 bogga per. Servers in la tirtiro ma aha ku jira.

Xuquuqda loo baahan yahay: servers:list

Cabbirrada Weydiinta

_Barnaamijyada	Nooca	Loo baahan yahay	Tilmaamaha
`page`	integer	Ha	Tirada bog, ka bilow 1
`page_size`	integer	Ha	Natiijooyinka bogga (default 25, ugu badnaan 100)

Codsi Tusaale ah

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

Jawaabta Tusaale

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

Goobaha Jawaabta

Isku-darka	Nooca	Tilmaamaha
`uuid`	string	Xidhiidhka serverka ee loo isticmaalo server kasta oo kale
`hostname`	string	Magaca martida aad dooratay markaad abuurayso server-ka
`status`	string	Dastuurka hadda. Ka eeg Server Dastuurka Qiimaha hoos.
`error_description`	string \| null	Faahfaahinta ku guul darreysiga ugu dambeeyay marka xaaladdu tahay khalad, haddii kale waa null
`location_name`	string	Magaca goobta server-ka ku socda
`os_name`	string	Magaca nidaamka hawlgalka, iyadoo aan la soo bandhigin nooca
`plan_name`	string	Qorshaha akhriska ah, tusaale ahaan 1 vCPU / 2 GB RAM / 10 GB
`ipv4_addresses`	array	IPv4 cinwaanka sida strings. Buuxa ilaa server waa la soo bandhigay, iyo qorshayaasha aan IPv4.
`ipv6_addresses`	array	IPv6 cinwaanka sida strings. Xoog ilaa server waa la soo bandhigay.
`created_at`	datetime	Waqtiga abuurista (ISO 8601, UTC)
`deployed`	boolean	Run marka la dhammeeyo

Koodhadhka Xaaladda Jawaab celinta

200	Si guul leh ayaa loo soo ceshaday liiska server-ka
403	Xiran ama aan sharci ahayn API token, ama token ka maqan oggolaanshaha loo baahan yahay

BOOQO /api/v1/servers/

Samee Server Cusub

Queues server cusub ee bixinta iyo dib u soo celin doonaa isla markiiba la status filaayo. Provisioning sii socdaa ee background: doorasho xaaladda endpoint ilaa bixinta waa run. Marka server waa diyaar, faahfaahinta login waxaa emailed in account owner.

Xisaabtaada waxay u baahan tahay hab lacag bixin ah oo la kaydiyay. Sida ku xiran taariikhdaada xisaabta, waqti-dhiman oo hore u-maamuus ah oo ku saabsan hal toddobaad oo qiimaha qorshaha ah (ugu yaraan 1 USD) ayaa laga yaabaa in la geliyo kaararkaada ka hor inta aan server-ka la abuurin.

Xuquuqda loo baahan yahay: servers:create

Codso Cabbirrada Jirka

_Barnaamijyada	Nooca	Loo baahan yahay	Tilmaamaha
`hostname`	string	Haa	Ugu yaraan 3 xarfo. Letters, lambarrada, isku xigta iyo waqti kaliya.
`location_id`	integer	Haa	Id-ka meel hawlan oo ka mid ah API-ga Meelaha
`plan_uuid`	string	Haa	Uuid of a qorshe hawlan ka API-ka qorshayaasha
`operating_system_version_uuid`	string	Haa	Uuid-ka ereyga hawlgalka ah ee liiska noocyada nidaamka hawlgalka
`ssh_key_uuids`	array	Ha	UUIDs of SSH furayaasha ka SSH furayaasha API in la rakibo server
`ssh_key_ids`	array	Ha	Id-yada buuxa ee furayaasha SSH, sida ikhtiyaar u ah ssh_key_uuids. Haddii labadaba la diro, ssh_key_ids ayaa la isticmaalaa.
`ssh_key_uuid`, `ssh_key_id`	string, integer	Ha	Faahfaahin u gaarka ah furayaasha SSH
`auth_method`	string	Ha	password, ssh_key ama labadaba. Defaults in password, ama labadaba marka SSH furayaasha la siiyo.

Codsi Tusaale ah

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

Jawaabta Tusaale

201 la abuuray server buuxa waxa ku qoran hoos Get Server Details. Adeegyada iyo vmid waxaa buuxiya mar kasta oo soo bandhigida dhamaystiran.

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

Koodhadhka Xaaladda Jawaab celinta

201	Server-ka ayaa la abuuray oo loo diyaariyey in la isticmaalo
400	Xaaladda xadgudubka, tusaale ahaan meel aan waxtar lahayn, qorshe ama noocyada nidaamka hawlgalka
402	Ma jiro habka lacag bixinta ee faylka, xisaabaadka aan la bixin, ama kaarka hore u oggolaanshaha ayaa la diiday
403	Xiran ama aan sharci ahayn API token, ama token ka maqan oggolaanshaha loo baahan yahay
429	Xisaabtaada waxay gaadhay xadka abuurista server-ka

HEL /api/v1/servers/{uuid}/

Hel Faahfaahinta Adeegaha

Ku soo laabtay server mid ah oo ay goobta, qorshaha, nidaamka hawlgalka, IP addresses iyo shan tallaabooyinka ugu dambeeyay.

Xuquuqda loo baahan yahay: servers:list

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

Jawaabta Tusaale

{
  "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 iyo nooca liiska waxaa la soo gaabiyey halkan.

Goobaha Jawaabta

Isku-darka	Nooca	Tilmaamaha
`vmid`	integer \| null	Virtual mashiinka lambarka, set inta lagu guda jiro soo bandhigid
`location`	object	wax goobta, sida ay ku soo laabtay goobaha API
`plan`	object	Qorshaha wax, sida ay ka soo laabtay API-ga Qorshaha
`operating_system`, `operating_system_version`	object	nidaamka hawlgalka iyo nooca la soo dejiyey, sida ay ku soo laabtay by nidaamka hawlgalka API
`ipv4_addresses`, `ipv6_addresses`	array	Mid ka mid ah wax kasta oo cinwaanka ah oo la ip, gateway, subnet iyo rdns (DNS ka soo horjeeda hostname)
`recent_actions`	array	ilaa shan dhaqdhaqaaqyada ugu dambeeyay: id, dhaqdhaqaaqa, action_display, sharaxaadda, user_email, created_at

Koodhadhka Xaaladda Jawaab celinta

200	Si guul leh ayaa loo soo ceshaday faahfaahinta server-ka
404	Ma la helin, ama waxay ka tirsan tahay xisaab kale

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

Ka hel xaaladda server-ka

A codsi fudud oo loogu talagalay codbixinta ka dib markii aad abuurto, awood ama resize 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
}

Qiimaha Xaaladda Server-ka

Qiimaha	Tilmaamaha
`queue`	Fal (soo bandhig, awood, bedesho, soo celin) ayaa la isku raacay ama socda
`deploying`	Servers abuuray ka panel maamulka isticmaalaan xaaladdan; servers abuuray iyada oo API ku noolaadaan in ay isku xigta ilaa ay diyaar u yihiin.
`on`	Socda
`off`	La xiray
`error`	Falkii ugu dambeeyey wuu fashilmay. Ka eeg tilmaamaha xadgudubka.
`suspended_payment`	Dhaqdhaqaaqa sababtoo ah xisaabaadka aan la bixin

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

Tallaabada 1:

Isku soo wada duuboo hawl awood ah. Server-ka xaaladdiisa ayaa u beddelaysa isku soo wada duuboo ilaa hawl la dhammeeyo.

Xuquuqda loo baahan yahay: servers:power

Codso Cabbirrada Jirka

_Barnaamijyada	Nooca	Loo baahan yahay	Tilmaamaha
`action`	string	Haa	`start`: awoodda `shutdown`: xafiiska ka go'id, ku qasbay off haddii martida ma joojin `restart`: xoog adag wareegga (joogso, ka dibna bilow) `stop`: hadda samaynaya wareegga awoodda isku mid ah sida dib u bilow. isticmaal shutdown in ay ka tagaan server off.

Codsi Tusaale ah

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

Jawaabta Tusaale

{
  "message": "Server restart queued"
}

Koodhadhka Xaaladda Jawaab celinta

200	Falku waa la isku raacay
400	Falka ka maqan ama aan la taageerin
402	bilow diiday sababtoo ah xisaabta waxaa ku jira xisaabaadka aan la bixin
404	Ma la helin, ama waxay ka tirsan tahay xisaab kale

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

Beddelka Miisaanka Server

Goobaha server in qorshe kale oo hawlgalka ah. qorshaha cusub ma laha meel disk ka yar midda hadda, iyo jirka codsiga waa in ay ku jiraan tallaabo set in ay resize. Hypervisor awooda qorshaha cusub waa la tijaabiyey ka hor wax kasta oo waa la filayaa, sidaas darteed codsiga diiday ka tagaa server aan la beddelin.

Server waa la xiray inta uu yahay sized iyo dib u bilaabay ka dib. Haddii resize ku fashilmaan, server waa dib loogu dhigay qorshihiisa hore iyo dib u bilaabay haddii uu socday. Disk koritaanka ma aha in la joojiyo.

Xuquuqda loo baahan yahay: servers:resize

Codso Cabbirrada Jirka

_Barnaamijyada	Nooca	Loo baahan yahay	Tilmaamaha
`action`	string	Haa	Waa in la bedelay
`new_plan_uuid`	string	Haa	Uuid-ka qorshaha loo gudbiyo

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

tusaale ah resize diiday (409):

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

Koodhadhka Xaaladda Jawaab celinta

200	Falku waa la isku raacay
400	Waxqabadka la'aan ama new_plan_uuid, qorshe aan sharci ahayn ama aan hawl lahayn, qorshe leh meel disk yar, ama qorshe GPU (GPU qorshayaasha ma aha in la kordhiyo API)
404	Ma la helin, ama waxay ka tirsan tahay xisaab kale
409	A resize ama kaydinta isbedelka waa horeba socda, ama ma jiro awood ku filan hypervisor u qorshaha cusub
503	Waxqabadka ma la hubin karo hadda. Server-ka ma la beddelin; dib u isku day ka dib.

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

Ku soo Celi Magaca Faylka

abuurtaa password root cusub, ku soo laabtay jawaabta iyo fariimaha isbeddelka server. password cusub waa sidoo kale emailed aad. server waa in la soo bandhigo. No codsiga jirka waa in la baahan yahay.

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

Koodhadhka Xaaladda Jawaab celinta

200	Falku waa la isku raacay
400	Server-ka ma la soo bandhigin weli
404	Ma la helin, ama waxay ka tirsan tahay xisaab kale

HEL BOOQO /api/v1/servers/{uuid}/rdns/

DNS-ka ka soo noqnoqda (PTR)

GET liiska DNS hostname ka soo horjeeda IPv4 iyo IPv6 aad u ah server kasta. POST wuxuu u dhigayaa mid aad u mid ah. Dib u dirista hostname aan waxba ka reebaysa cinwaanka si ay u default DNS magaciisa ka soo horjeeda.

Xuquuqda loo baahan yahay: servers:update

Codso Cabbirrada Jirka (POST)

_Barnaamijyada	Nooca	Loo baahan yahay	Tilmaamaha
`ip`	string	Haa	A IPv4 ama IPv6 cinwaanka loo magacaabay server this
`hostname`	string	Ha	Magaca martida PTR. Ka tag meel aan la buuxin si aad u soo celiso qaabka caadiga ah.

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

Jawaabta GET:

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

Koodhadhka Xaaladda Jawaab celinta

400	ip ka maqan, ama magac-host-ka ma la soo dejin karo
404	Xarunta IP-ga lama siin server-kan

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

Ku fuliyo amar server

Runs a shell command inside the server through the QEMU guest agent and waits for it to finish. The server must be deployed and running, and qemu-guest-agent must be installed and running in the guest.

Xuquuqda loo baahan yahay: servers:exec

Codso Cabbirrada Jirka

_Barnaamijyada	Nooca	Loo baahan yahay	Tilmaamaha
`command`	string	Haa	Amarka line socda la /bin/sh -c, ilaa 2000 xarfo
`timeout`	integer	Ha	Ilbiriqsiyada la sugayo amarka, 1 ilaa 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
}

Haddii amarku weli socda marka timeout dhamaado, jawaabta waxaa timed_out loo dhigay si run ah iyo exit_code loo dhigay si null.

Koodhadhka Xaaladda Jawaab celinta

200	Amarka waa la dhammeeyey ama waa waqti dhamaaday
400	Server aan la soo bandhigin ama aan la socon, ama parameters aan sharci ahayn
409	Adeegga martida QEMU ma socon karo server-ka
503	Xidhiidh waqti-buuxa ah. Ku soo celi ka dib markii Retry-After header.

TIRTIR /api/v1/servers/{uuid}/

Tirtir Server-ka

Server-ka u kala qaybiya in la tirtiro. Server-ka ayaa ka tagaya liiska isla markiiba mana la soo celin karo.

Xuquuqda loo baahan yahay: 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"
}

Koodhadhka Xaaladda Jawaab celinta

202	Aqbalay: codsiga waxaa la soo xiray
404	Ma la helin, ama waxay ka tirsan tahay xisaab kale

HEL BOOQO /api/v1/ssh-keys/

Furayaasha SSH

Ku kaydi furaha SSH dadweynaha xisaabtaada, ka dibna u gudbiyaan uuids sida ssh_key_uuids marka aad abuurto server. GET liiska furahaaga (25 bogga); POST ku daray mid.

Xuquuqda loo baahan yahay: ssh-keys:list (GET), ssh-keys:create (POST)

Codso Cabbirrada Jirka (POST)

_Barnaamijyada	Nooca	Loo baahan yahay	Tilmaamaha
`name`	string	Haa	Magaca loo aqoonsado furaha, ilaa 100 xarfo
`public_key`	string	Haa	Fursada dadweynaha ee qaabka OpenSSH, tusaale ahaan waxa ku jira id_ed25519.pub

Codsi Tusaale ah

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

Jawaabta Tusaale

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

Goobaha Jawaabta

Isku-darka	Nooca	Tilmaamaha
`id`, `uuid`	integer, string	Key aqoonsi. U isticmaal uuid in ssh_key_uuids iyo in URL hoos ku qoran; id shaqooyinka in ssh_key_ids.
`fingerprint`	string	MD5 calaamadda gacmaha ee furaha, la xisaabiyey by platform
`last_used_at`	datetime \| null	Marka ugu danbaysay ee furaha lagu rakibay server cusub

Koodhadhka Xaaladda Jawaab celinta

201	Faqliga la soo daray
400	Magaca oo maqan, ama furaha dadweynaha ma aha furaha dadweynaha SSH ee saxda ah

HEL TIRTIR /api/v1/ssh-keys/{uuid}/

Ka hel ama ka tirtir furayaasha SSH

GET ku soo laabtay hal fure oo la goobaha kor ku xusan. DELETE ka saaraa kaaga xisaabtaada oo ku soo laabtay 204 oo aan jirka. tirtirka furaha ma ka saaro servers uu horey u soo dejiyey on. Furayaasha ma aha in la edit: tirtirto oo ku darto mar kale.

Xuquuqda loo baahan yahay: 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"

Dib u soo celin iyo Snapshots

Abuuritaanka a backup ama snapshot waa sidoo kale hawl server:

POST /api/v1/servers/{uuid}/backup/: Kaydinta API
POST /api/v1/servers/{uuid}/snapshot/: Sawirrada API-ga

VPS.org API

Server-yada API

Liis garee Dhammaan Adeegayaasha

Cabbirrada Weydiinta

Codsi Tusaale ah

Jawaabta Tusaale

Goobaha Jawaabta

Koodhadhka Xaaladda Jawaab celinta

Samee Server Cusub

Codso Cabbirrada Jirka

Codsi Tusaale ah

Jawaabta Tusaale

Koodhadhka Xaaladda Jawaab celinta

Hel Faahfaahinta Adeegaha

Jawaabta Tusaale

Goobaha Jawaabta

Koodhadhka Xaaladda Jawaab celinta

Ka hel xaaladda server-ka

Qiimaha Xaaladda Server-ka

Tallaabada 1:

Codso Cabbirrada Jirka

Codsi Tusaale ah

Jawaabta Tusaale

Koodhadhka Xaaladda Jawaab celinta

Beddelka Miisaanka Server

Codso Cabbirrada Jirka

Koodhadhka Xaaladda Jawaab celinta

Ku soo Celi Magaca Faylka

Koodhadhka Xaaladda Jawaab celinta

DNS-ka ka soo noqnoqda (PTR)

Codso Cabbirrada Jirka (POST)

Koodhadhka Xaaladda Jawaab celinta

Ku fuliyo amar server

Codso Cabbirrada Jirka

Koodhadhka Xaaladda Jawaab celinta

Tirtir Server-ka

Koodhadhka Xaaladda Jawaab celinta

Furayaasha SSH

Codso Cabbirrada Jirka (POST)

Codsi Tusaale ah

Jawaabta Tusaale

Goobaha Jawaabta

Koodhadhka Xaaladda Jawaab celinta

Ka hel ama ka tirtir furayaasha SSH

Dib u soo celin iyo Snapshots