API ya Ma seva

Pezani /api/v1/servers/

Lembani Ma seva Onse

Kubwerera ma seva mu akaunti yanu, zatsopano koyamba, 25 patsamba. Mawebusayiti omwe akuthetsedwa sizikuphatikizapo.

Kufunikira kwa ufulu: servers:list

Ma Parameter a Mafunso

Paramita	Mtundu	Zofunika	Kufotokozera
`page`	integer	Si	Nambala ya tsamba, imayamba pa 1
`page_size`	integer	Si	Mayankho patsamba (default 25, maximum 100)

Chitsanzo cha Pempho

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

Chitsanzo cha Yankho

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

Mayankho a Minda

Kuwala	Mtundu	Kufotokozera
`uuid`	string	Kudziwitsa kwa seva kumagwiritsidwa ntchito pazomaliza zonse za seva zina
`hostname`	string	dzina la m'malo lomwe munasankha pamene munapanga seva
`status`	string	State watsopano. Onani Server State Values pansipa.
`error_description`	string \| null	Zithunzi za kulephera komaliza pamene khalidwe ndi vuto, ngati sichoncho null
`location_name`	string	dzina la malo omwe seva imagwira ntchito
`os_name`	string	dzina la dongosolo logwiritsira ntchito, popanda mtundu
`plan_name`	string	Kumvetsetsa kwa ndondomeko yowerengera, mwachitsanzo 1 vCPU / 2 GB RAM / 10 GB
`ipv4_addresses`	array	IPv4 adiresi monga masamba. Cholakwika mpaka wothandizira ndi kukhazikitsidwa, ndi pa maphunziro popanda IPv4.
`ipv6_addresses`	array	IPv6 adiresi monga strings. Cholakwika mpaka wothandizira akonzedwe.
`created_at`	datetime	Nthawi yopangidwa (ISO 8601, UTC)
`deployed`	boolean	Chowona pamene kuikapo ntchito kwatha

Makhodi a Mkhalidwe Woyankha

200	Ndapeza bwino mnda wa seva
403	Kukayika kapena ayi API token, kapena token alibe zofunika chilolezo

POST /api/v1/servers/

Pangani Seva Yatsopano

Kuyika m'gulu seva yatsopano yogwiritsira ntchito ndipo imabwereranso mofulumira ndi ndondomeko yoyang'anira. Kukhazikitsa kumapita patsogolo m'mbali: kufunsa ndondomeko yomaliza mpaka kukhazikitsidwa kwa lamulo. Ngati seva ndi yoyenera, zidziwitso zake zologedwa zimatumizidwa ku m'manja kwa wogwiritsa ntchito akaunti.

Kutengera ndi mbiri ya akaunti yanu, kuthekera kokhala ndi chilolezo choyamba chanthawi yayitali cha pafupifupi sabata imodzi cha mtengo wa akaunti (osachepera $ 1 USD) kungagwiritsidwe ntchito pakhadi lanu la ngongole pambuyo popanga seva.

Kufunikira kwa ufulu: servers:create

Pemphani Ma Parameter a Thupi

Paramita	Mtundu	Zofunika	Kufotokozera
`hostname`	string	Inde	Kutalika kwa mawu osachepera 3. Malemba, zilembo, ma anchors ndi ma periods okha.
`location_id`	integer	Inde	ID ya malo ogwira ntchito kuchokera ku Locations API
`plan_uuid`	string	Inde	Uuid ya ntchito yogwira ntchito kuchokera ku Plans API
`operating_system_version_uuid`	string	Inde	Uuid ya kulowa kogwira ntchito m'gulu la zigawo za dongosolo logwiritsira ntchito
`ssh_key_uuids`	array	Si	UUIDs ya SSH mabowo kuchokera SSH mabowo API kuti ayambe pa seva
`ssh_key_ids`	array	Si	Ma id amodzi a SSH, monga njira ina ya ssh_key_uuids. Ngati onse awiriwa atumizidwa, ssh_key_ids amagwiritsa ntchito.
`ssh_key_uuid`, `ssh_key_id`	string, integer	Si	Mfupikitso cha chikwatu chimodzi cha SSH
`auth_method`	string	Si	password, ssh_key kapena onse awiri. Zolakwika ndi password, kapena onse awiri pamene SSH mabowo ali operekedwa.

Chitsanzo cha Pempho

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

Chitsanzo cha Yankho

201 Amapangidwa ndi server wonse chinthu anafotokoza pansi Get Server Deta. Addresses ndi vmid ndi anawonjezera mu nthawi yoyamba kukhazikitsa kumatha.

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

Makhodi a Mkhalidwe Woyankha

201	Server yapangidwa ndi kuikidwa musanagwiritsidwe ntchito
400	Kulephera kwa kutsimikizika, monga malo osagwira ntchito, ndondomeko kapena mtundu wa dongosolo logwiritsira ntchito
402	Simunalembetse njira yolipira, simunalandire ndalama, kapena kuvomerezedwa kwa katunduyo kunalepheredwa
403	Kukayika kapena ayi API token, kapena token alibe zofunika chilolezo
429	Akaunti yanu yafika pa mlingo wopanga server

Pezani /api/v1/servers/{uuid}/

Pezani Tsatanetsatane wa Seva

Imabwerera server imodzi ndi malo ake, ndondomeko, dongosolo loyendetsa, IP adilesi ndi ntchito zaposachedwapa zisanu.

Kufunikira kwa ufulu: servers:list

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

Chitsanzo cha Yankho

{
  "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 ndi mnda wa machitidwe ndi kufupikitsa pano.

Mayankho a Minda

Kuwala	Mtundu	Kufotokozera
`vmid`	integer \| null	Virtual makina mnda, anaika pamene kukhazikitsa
`location`	object	Malo a chinthu, monga momwe amatulutsidwa ndi malo API
`plan`	object	Plan object, monga momwe amatulutsidwa ndi Plans API
`operating_system`, `operating_system_version`	object	Chida chogwiritsira ntchito ndi mtundu wake woyikidwa, monga momwe chimaperekedwa ndi chida chogwiritsira ntchito API
`ipv4_addresses`, `ipv6_addresses`	array	Mmodzi wa zinthu pa adiresi ndi ip, gateway, subnet ndi rdns (yotsutsana DNS hostname)
`recent_actions`	array	Kufika pazochita zaposachedwapa zisanu: id, ntchito, ntchito_display, kufotokozera, user_email, created_at

Makhodi a Mkhalidwe Woyankha

200	Ndapeza bwino zambiri za seva
404	Siyipezeka, kapena ili ndi akaunti ina

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

Kupeza Server Status

A lightweight kufunsa kwa polling pambuyo inu kulenga, mphamvu kapena kusintha kukula kwa seva.

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
}

Makhalidwe a server

Mtengo	Kufotokozera
`queue`	Chimene chikuchitika (kukhazikitsa, kulowa mphamvu, kusintha kukula, kubwezeretsa) chili m'gulu kapena chikuchitika
`deploying`	Ma seva opangidwa kuchokera ku gulu la kuwongolera kugwiritsa ntchito izi dziko; ma seva opangidwa mwa API azikhala mu mnda wazoyembekezera mpaka atatha.
`on`	Kuyenda
`off`	Opanda mphamvu
`error`	Chimene chinachitika pamapeto pake sichinatheke. Onani error_description.
`suspended_payment`	Kulephera chifukwa cha invoices osalipira

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

Kuwongolera Server Power

Amaika m'gulu ntchito ya mphamvu. Mtundu wa seva umasintha kukhala m'gulu mpaka ntchitoyo ifike.

Kufunikira kwa ufulu: servers:power

Pemphani Ma Parameter a Thupi

Paramita	Mtundu	Zofunika	Kufotokozera
`action`	string	Inde	`start`: power on `shutdown`: chisokonezo chabwino, cholepheretsa ngati woyang'anira saletsa `restart`: hard mphamvu chigawo (kulephera, ndiye kuyamba) `stop`: currently performs the same power cycle as restart. Use shutdown to leave a server off.

Chitsanzo cha Pempho

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

Chitsanzo cha Yankho

{
  "message": "Server restart queued"
}

Makhodi a Mkhalidwe Woyankha

200	Chikhalidwechi chinali chosagwirizana
400	Chimene chikulephera kapena chosagwirizana ndi ntchito
402	kuyamba anakana chifukwa akaunti ali zosalipira invoices
404	Siyipezeka, kapena ili ndi akaunti ina

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

Kusintha kwa server

Ikani seva ku njira ina yogwira ntchito. Njira yatsopano siyingathe kukhala ndi malo osachepera pa diski kuposa amene ali pano, ndipo thupi la funso liyenera kuphatikizapo ntchito yosinthira kukula. Kutha kwa hypervisor kwa njira yatsopano kumayesedwa panthawi yoyang'anira chilichonse, kotero funso lokana limasiya seva yosasinthidwa.

Mtumiki amatseka pamene akusintha kukula kwake ndipo amayambanso pambuyo pake. Ngati kusintha kukula kwake kumalephera, mtumiki amabwereranso ku ndondomeko yake yapitayo ndipo amayambanso ngati anali kuyendetsa. Kukula kwa diski sikungachitike.

Kufunikira kwa ufulu: servers:resize

Pemphani Ma Parameter a Thupi

Paramita	Mtundu	Zofunika	Kufotokozera
`action`	string	Inde	Muyenera kusinthidwa
`new_plan_uuid`	string	Inde	Uuid ya ndondomeko yosinthidwa

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

Mofananamo, chitsanzo cha resize anakana (409):

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

Makhodi a Mkhalidwe Woyankha

200	Chikhalidwechi chinali chosagwirizana
400	Kukayika kwa ntchito kapena new_plan_uuid, ndondomeko yosavomerezeka kapena yosagwira ntchito, ndondomeko yokhala ndi malo ochepa pa diski, kapena ndondomeko ya GPU (ndondomeko ya GPU siyingathe kusinthidwa kukula mwa API)
404	Siyipezeka, kapena ili ndi akaunti ina
409	Kusintha kwa kukula kapena kusungirako kwasintha kale, kapena palibe hypervisor yokwanira yokwanira kwa ndondomeko yatsopano
503	Kutha kwa disk sikunathe kutsimikiziridwa pano. Seva siinasinthidwe; onetsetsani kuti mwayesetsanso pambuyo pake.

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

Kusintha Password ya root

Amapanga mawu achinsinsi a root atsopano, amawabweretsa m'mafunso ndi kuika kusintha kwa server mu mnda. Mawu achinsinsi atsopano amatumizidwanso kwa inu pa imelo. Mawebusayiti ayenera kukhazikitsidwa. Simungafune thupi la funso.

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

Makhodi a Mkhalidwe Woyankha

200	Chikhalidwechi chinali chosagwirizana
400	Mtumiki sikuti wakonzedwa
404	Siyipezeka, kapena ili ndi akaunti ina

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

DNS yosinthika (PTR)

GET amasonyeza dzina la DNS la mnzake wa IPv4 ndi IPv6 pa seva. POST imaika dzinali pa adiresi imodzi. Kutumiza dzina la mnzake wa mnzake lopanda malire kumabwezeretsa adiresi ku dzina la DNS la mnzake wa DNS.

Kufunikira kwa ufulu: servers:update

Pemphani Ma Parameter a Thupi (POST)

Paramita	Mtundu	Zofunika	Kufotokozera
`ip`	string	Inde	Adiresi ya IPv4 kapena IPv6 yoperekedwa kwa wothandizira
`hostname`	string	Si	PTR dzina la ma host. Ikani pansi kuti mubwezeretse ku default.

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

GET yankho:

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

Makhodi a Mkhalidwe Woyankha

400	ip imabwera, kapena dzina la woyang'anira silitha kukhazikitsidwa
404	Adiresi ya IP siyikuperekedwa kwa server iyi

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

Kuchita lamulo pa server

Idzagwira ntchito ya shell command m'manja mwa server mwa kudzera kwa QEMU guest agent ndi kuyembekezera kuti ipite patsogolo. Server iyenera kukhala yosinthidwa ndi kuyendetsa, ndi qemu-guest-agent iyenera kukhala yoyikidwa ndi kuyendetsa m'gulu la oyang'anira.

Kufunikira kwa ufulu: servers:exec

Pemphani Ma Parameter a Thupi

Paramita	Mtundu	Zofunika	Kufotokozera
`command`	string	Inde	Kuyenda kwa liwiro la command ndi /bin/sh -c, mpaka maonekedwe 2000
`timeout`	integer	Si	Masekondi oyembekezeredwa kuti apereke lamulo, 1 mpaka 300 (zosasinthika 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
}

Ngati malamulo ndibe kuyendetsa pamene timeout kumatha, yankho ali timed_out set kuti true ndi exit_code set kuti null.

Makhodi a Mkhalidwe Woyankha

200	Kuletsa kwachidule
400	Server siyimagwira ntchito kapena siyimagwira ntchito, kapena pali zinthu zosagwirizana
409	QEMU guest agent siyikugwira ntchito pa seva
503	Kulumikizana kwa nthawi yochepa. Pitaninso pambuyo pa Retry-After header.

CHOTSANI /api/v1/servers/{uuid}/

Chotsani Seva

Imangoika server mu mnda kuti ichotsedwe mwamsanga. Server idzatuluka m'mnda mwamsanga ndipo siyidzatha kubwezeretsedwanso.

Kufunikira kwa ufulu: 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"
}

Makhodi a Mkhalidwe Woyankha

202	Yavomerezedwa: lamuloli linali m'gulu
404	Siyipezeka, kapena ili ndi akaunti ina

Pezani POST /api/v1/ssh-keys/

Ma Keys a SSH

Kusunga anthu SSH mabowo mu akaunti yanu, ndiye kutumiza awo uuids monga ssh_key_uuids pamene inu kulenga server. GET limatiuza mabowo anu (25 pa tsamba); POST awonjezera mmodzi.

Kufunikira kwa ufulu: ssh-keys:list (GET), ssh-keys:create (POST)

Pemphani Ma Parameter a Thupi (POST)

Paramita	Mtundu	Zofunika	Kufotokozera
`name`	string	Inde	dzina kuti adziwe batani ndi, mpaka 100 zilembo
`public_key`	string	Inde	Chingwe cha anthu m'njira ya OpenSSH, mwachitsanzo zomwe zili mu id_ed25519.pub

Chitsanzo cha Pempho

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

Chitsanzo cha Yankho

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

Mayankho a Minda

Kuwala	Mtundu	Kufotokozera
`id`, `uuid`	integer, string	Kuzindikira kwa maziko. Pezani uuid mu ssh_key_uuids ndi mu URL pansipa; id imagwira ntchito mu ssh_key_ids.
`fingerprint`	string	MD5 fingerprint ya key, yowerengedwa ndi platform
`last_used_at`	datetime \| null	Nthawi yomwe chiphasochi chinali chokhazikitsidwa pa seva yatsopano

Makhodi a Mkhalidwe Woyankha

201	Chithunzi
400	Palibe dzina, kapena chiphaso cha anthu sichiyenera kukhala chiphaso cha anthu cha SSH

Pezani CHOTSANI /api/v1/ssh-keys/{uuid}/

Kupeza kapena kuchotsa SSH Key

GET imabweretsa batani limodzi ndi malo pamwambapa. DELETE imachotsa batani kuchokera pa akaunti yanu ndipo imabweretsa 204 popanda thupi. Kuchotsa batani sikunachitike kuchokera pa seva zomwe zidayikidwa. Batani silitha kusinthidwa: kuchotsa ndi kuwonjezeranso.

Kufunikira kwa ufulu: 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 ndi Snapshots

Kulenga kubwerera kamodzi kapena snapshot ndinso ntchito server:

POST /api/v1/servers/{uuid}/backup/: API Yosungira Zinthu Zosungidwa
POST /api/v1/servers/{uuid}/snapshot/: Zithunzi Zazing'ono API

VPS.org API

Lembani Ma seva Onse

Ma Parameter a Mafunso

Chitsanzo cha Pempho

Chitsanzo cha Yankho

Mayankho a Minda

Makhodi a Mkhalidwe Woyankha

Pangani Seva Yatsopano

Pemphani Ma Parameter a Thupi

Chitsanzo cha Pempho

Chitsanzo cha Yankho

Makhodi a Mkhalidwe Woyankha

Pezani Tsatanetsatane wa Seva

Chitsanzo cha Yankho

Mayankho a Minda

Makhodi a Mkhalidwe Woyankha

Kupeza Server Status

Makhalidwe a server

Kuwongolera Server Power

Pemphani Ma Parameter a Thupi

Chitsanzo cha Pempho

Chitsanzo cha Yankho

Makhodi a Mkhalidwe Woyankha

Kusintha kwa server

Pemphani Ma Parameter a Thupi

Makhodi a Mkhalidwe Woyankha

Kusintha Password ya root

Makhodi a Mkhalidwe Woyankha

DNS yosinthika (PTR)

Pemphani Ma Parameter a Thupi (POST)

Makhodi a Mkhalidwe Woyankha

Kuchita lamulo pa server

Pemphani Ma Parameter a Thupi

Makhodi a Mkhalidwe Woyankha

Chotsani Seva

Makhodi a Mkhalidwe Woyankha

Ma Keys a SSH

Pemphani Ma Parameter a Thupi (POST)

Chitsanzo cha Pempho

Chitsanzo cha Yankho

Mayankho a Minda

Makhodi a Mkhalidwe Woyankha

Kupeza kapena kuchotsa SSH Key

Backups ndi Snapshots