API ho an'ny mpizara

ALAO /api/v1/servers/

Tanisao ny mpizara rehetra

Maneho ireo mpizara ao amin'ny kaontinao, ny vaovao indrindra aloha, 25 isan-pejy. Tsy tafiditra ireo mpizara fafàna.

Mila alalana: servers:list

Paramètres de requête

Mpizahaky ny macro	Karazana	ilaina	Fanoritsoritana
`page`	integer	Tsy misy	Isan'ny pejy, manomboka amin'ny 1
`page_size`	integer	Tsy misy	Valiny isaky ny pejy (25 tsotra, 100 farafahakeliny)

Ohatra amin'ny fangatahana

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

Ohatra amin'ny Valiny

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

Saha Valiny

Field	Karazana	Fanoritsoritana
`uuid`	string	Ny mpizara ampiasaina amin'ny mpizara hafa rehetra
`hostname`	string	Anaran'ny mpampiantrano nataonao teo am-panovana ilay mpizara
`status`	string	Ny toe-draharaha ankehitriny. Jereo eto ambany ny sanda momba ny toe-draharahan'ny mpizara.
`error_description`	string \| null	Antsipirian'ny tsy fetezana farany raha toa ka tsy fetezana ny toe-javatra, raha tsy izany dia tsy misy
`location_name`	string	Anaran'ny toerana iandraiketan'ny mpizara
`os_name`	string	Anaran'ny rafitra fiasa, tsy misy kinova
`plan_name`	string	Famintinana ny drafitra azo vakiana, ohatra 1 vCPU / 2 GB RAM / 10 GB
`ipv4_addresses`	array	Adiresy IPv4 amin'ny endri-daha-daza. Foana mandra-pahatongan'ny fametrahana ny mpizara, ary amin'ny drafitra tsy misy IPv4.
`ipv6_addresses`	array	Adiresy IPv6 amin'ny endri-daha-daza. Foana mandra-pahatongan'ny fametrahana ny mpizara.
`created_at`	datetime	Fotoana namoronana (ISO 8601, UTC)
`deployed`	boolean	Marina rehefa vita ny fampidirana

Kaody momba ny satan'ny valiny

200	Voaray soa aman-tsara ny lisitry ny mpizara
403	Token API tsy misy na tsy mitombina, na tsy manana ny fahazoan-dàlana ilaina ilay token

POST /api/v1/servers/

Mamoròna mpizara vaovao

Mametraka mpizara vaovao ho an'ny fampidirana anaty filaharana, ary mandefa azy avy hatrany miaraka amin'ny filaharan'ny toe-draharaha. Mitohy any afara ny fampidirana: manontany ny endpoint'ny toe-draharaha mandra-pahatongan'ny hoe marina ny fampidirana. Raha efa vonona ny mpizara, dia alefa amin'ny mailaka any amin'ny tompon'ny kaonty ny mombamomba ny fidirana.

Mila fomba fandoavam-bola voatahiry ny kaontinao. Araka ny tantaran'ny kaontinao, mety hisy ny fampiatoana vonjimaika ny fahazoan-dàlana mialoha mandritra ny herinandro iray eo ho eo amin'ny vidiny (1 USD farafahakeliny) eo amin'ny karatrao alohan'ny hamoronana ny mpizara.

Mila alalana: servers:create

Fangatahana masontsivana momba ny vatana

Mpizahaky ny macro	Karazana	ilaina	Fanoritsoritana
`hostname`	string	ENY	Marika 3 farafahakeliny. Soratra, isa, tsipika ary fehezanteny ihany.
`location_id`	integer	ENY	Ny ID'ny toerana miasa avy amin'ny API'ny Toerana
`plan_uuid`	string	ENY	Ny uuid'ny drafitra miasa avy amin'ny API Plans
`operating_system_version_uuid`	string	ENY	Ny uuid'ny fidirana miasa anatin'ny lisitr'ireo kinova amin'ny rafitra fiasa iray
`ssh_key_uuids`	array	Tsy misy	UUID'ny famaha SSH avy amin'ny API'ny famaha SSH hapetraka amin'ny mpizara
`ssh_key_ids`	array	Tsy misy	Isa feno ny ID'ny famaha SSH, safidy amin'ny ssh_key_uuids. Raha samy alefa daholo izy roa ireo, dia ny ssh_key_ids no ampiasaina.
`ssh_key_uuid`, `ssh_key_id`	string, integer	Tsy misy	Teny fohy ho an'ny famaha SSH tokana
`auth_method`	string	Tsy misy	teny fanalahidy, famaha_ssh na izy roa. Teny fanalahidy na izy roa no sanda tsotra rehefa misy famaha SSH.

Ohatra amin'ny fangatahana

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

Ohatra amin'ny Valiny

201 Natao tamin'ny alalan'ny zavatra mpizara feno voalaza ao amin'ny Get Server Details. Hamenoina rehefa vita ny fampidirana ny adiresy sy ny vmid.

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

Kaody momba ny satan'ny valiny

201	Mpizara noforonina ary napetraka ho an'ny fampidirana
400	Tsy fetezan'ny fanamarinana, ohatra toerana tsy miasa, drafitra na kinova rafitra fiasa
402	Tsy misy fomba fandoavam-bola voarakitra, na vola tsy voaloa, na nolavina ny fanamarinana mialoha ny karatra
403	Token API tsy misy na tsy mitombina, na tsy manana ny fahazoan-dàlana ilaina ilay token
429	Efa nahatratra ny fetra amin'ny famoronana mpizara ny kaontinao

ALAO /api/v1/servers/{uuid}/

Makà antsipirian'ny mpizara

Mamaly mpizara iray miaraka amin'ny toerana misy azy, ny drafitra, ny rafitra fiasa, ny adiresy IP ary ny asa dimy farany.

Mila alalana: servers:list

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

Ohatra amin'ny Valiny

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

Ao amin'ny lisitra ny soratra sy ny soratra miisa ao amin'ny Baiboly.

Saha Valiny

Field	Karazana	Fanoritsoritana
`vmid`	integer \| null	Isan'ny milina virtoaly, voafaritra mandritra ny fampidirana
`location`	object	Ny zavatra misy ny toerana, araka ny atolotry ny API Locations
`plan`	object	Ny zavatra Plan, araka ny natolotry ny API Plans
`operating_system`, `operating_system_version`	object	Ny rafi-piasana sy ny kinova napetraka, araka ny natolotry ny APIn'ny rafi-piasana
`ipv4_addresses`, `ipv6_addresses`	array	Zavatra iray isaky ny adiresy miaraka amin'ny ip, gateway, zana-rezo ary rdns (ny anaran-drafitra DNS miverina)
`recent_actions`	array	Hatramin'ny dimy amin'ireo asa farany: id, action, action_display, description, user_email, created_at

Kaody momba ny satan'ny valiny

200	Voaray soa aman-tsara ny antsipirian'ny mpizara
404	Tsy hita, na an'ny kaonty hafa izy io

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

Maka ny toetr'ilay mpizara

Antso tsotra ho an'ny fitsapan-kevitra aorian'ny famoronana, fandefasana na fanovana ny haben'ny mpizara.

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
}

Sandan'ny toetran'ny mpizara

Sanda	Fanoritsoritana
`queue`	Misy asa (fandefasana, herinaratra, fanovana habe, famerenana) miandry na mandeha
`deploying`	Mampiasà io toe-javatra io ireo mpizara noforonina avy amin'ny tontonana fifehezana; mijanona anaty filaharana mandra-pahatongan'ny fotoana mety ireo mpizara noforonina tamin'ny alalan'ny API.
`on`	Mandeha
`off`	Voafafa
`error`	Tsy nahomby ny asa farany. Jereo ny error_description.
`suspended_payment`	Voaato noho ny tsy fandoavana ny volavolan-dalàna

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

Manara-maso ny herin'ny mpizara

Mametraka asa iray amin'ny filaharana. Manova ho filaharana ny toetran'ny mpizara mandra-pahatongan'ny fanatanterahana ilay asa.

Mila alalana: servers:power

Fangatahana masontsivana momba ny vatana

Mpizahaky ny macro	Karazana	ilaina	Fanoritsoritana
`action`	string	ENY	`start`: power on `shutdown`: fiatoana tsara, terena hiato raha tsy mitsahatra ny vahiny `restart`: Fihodinan'ny herinaratra mafy (atohy, avy eo atombohy) `stop`: Mandray ny fihodinan'ny herinaratra mitovy amin'ny famerenana miainga. Ampiasao ny shutdown raha te hamela mpizara iray tsy miasa.

Ohatra amin'ny fangatahana

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

Ohatra amin'ny Valiny

{
  "message": "Server restart queued"
}

Kaody momba ny satan'ny valiny

200	Voasoratra anatin'ny filaharana ilay asa
400	Asa tsy misy na tsy raisina an-tànana
402	Nolavina ny fanombohana satria misy vola tsy voaloa ao amin'ilay kaonty
404	Tsy hita, na an'ny kaonty hafa izy io

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

Hanova ny haben'ny mpizara

Mampandeha ny mpizara mankany amin'ny drafitra iray hafa miasa. Tsy afaka manana toerana kely kokoa amin'ny kapila noho ny amin'izao ny drafitra vaovao, ary tsy maintsy ahitana asa voafaritra ho amin'ny fanovana habe ny vatana. Voajery alohan'ny hametrahana zavatra amin'ny filaharana ny fahafahan'ny mpizaha ny drafitra vaovao, ka tsy miova ny mpizara raha misy fangatahana tsy ekena.

Atsahatra mandritra ny fanovana habe ny mpizara ary averina alefa aorian'izay. Raha tsy nahomby ny fanovana habe, dia averina amin'ny fomba taloha ny mpizara ary averina alefa indray raha mbola mandeha. Tsy azo atao ny manafoana ny fitomboan'ny kapila.

Mila alalana: servers:resize

Fangatahana masontsivana momba ny vatana

Mpizahaky ny macro	Karazana	ilaina	Fanoritsoritana
`action`	string	ENY	Tsy maintsy ovaina ny habeny
`new_plan_uuid`	string	ENY	Ny uuid'ilay drafitra afindra

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

Ohatra amin'ny fanovana habe tsy neken'ny mpampiasa (409):

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

Kaody momba ny satan'ny valiny

200	Voasoratra anatin'ny filaharana ilay asa
400	Asa tsy hita na new_plan_uuid, drafitra tsy mety na tsy miasa, drafitra manana toerana kely amin'ny kapila, na drafitra GPU (tsy azo ovaina habe amin'ny alalan'ny API ny drafitra GPU)
404	Tsy hita, na an'ny kaonty hafa izy io
409	Efa misy fanovana habe na fitehirizana mandeha, na tsy ampy ny fahafahan'ny hypervisor ho an'ny drafitra vaovao
503	Tsy afaka nijery ny fahafahana amin'izao fotoana izao. Tsy niova ny mpizara; andramo indray aorian'izay.

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

Reset Root Password

Mamorona teny fanalahidy vaovao ho an'ny faka, averina amin'ny valinteny ary apetraka amin'ny filaharana eo amin'ny mpizara ny fanovana. Alefa amin'ny mailaka ihany koa ny teny fanalahidy vaovao. Tsy maintsy apetraka ny mpizara. Tsy ilaina ny vatana.

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

Kaody momba ny satan'ny valiny

200	Voasoratra anatin'ny filaharana ilay asa
400	Tsy mbola napetraka ilay mpizara
404	Tsy hita, na an'ny kaonty hafa izy io

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

DNS miverina (PTR)

Ny GET dia mametraka ny anaran'ny mpampiantrano DNS miverina ho an'ny adiresy IPv4 sy IPv6 tsirairay ao amin'ny mpizara. Ny POST dia mamaritra izany ho an'ny adiresy iray. Ny fandefasana anaran'ny mpampiantrano foana dia mamerina ilay adiresy amin'ny anarany DNS miverina lasitra.

Mila alalana: servers:update

Fangatahana masontsivana momba ny vatana (POST)

Mpizahaky ny macro	Karazana	ilaina	Fanoritsoritana
`ip`	string	ENY	Adiresy IPv4 na IPv6 nomena ity mpizara ity
`hostname`	string	Tsy misy	Ny anaran'ny mpampiantrano PTR. Avelao foana io raha haverina amin'ny laoniny.

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

Valiny GET:

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

Kaody momba ny satan'ny valiny

400	Tsy misy ny ip, na tsy mety voafaritra ny anaran'ny mpampiantrano
404	Tsy misy adiresy IP nomena ho an'ity mpizara ity

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

Mandefa baiko amin'ny mpizara iray

Mandefa baiko shell ao anatin'ny mpizara amin'ny alalan'ny mpizaha vahiny QEMU ary miandry ny fiafaran'izany. Tsy maintsy apetraka sy mandeha ny mpizara, ary tsy maintsy apetraka sy mandeha ao anatin'ny vahiny ny qemu-guest-agent.

Mila alalana: servers:exec

Fangatahana masontsivana momba ny vatana

Mpizahaky ny macro	Karazana	ilaina	Fanoritsoritana
`command`	string	ENY	Lazam-baiko alefa amin'ny alalan'ny /bin/sh -c, hatramin'ny marika 2000
`timeout`	integer	Tsy misy	Ny segondra iandrasana ny baiko, 1 ka hatramin'ny 300 (30 ny sanda tsotra)

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
}

Raha mbola mandeha ilay baiko rehefa tapitra ny fe-potoana, dia ho marina ny timed_out ary tsy misy ny exit_code.

Kaody momba ny satan'ny valiny

200	Tapitra na tapitra ny fotoanan'ilay baiko
400	Tsy napetraka na tsy mandeha ilay mpizara, na misy mpizara tsy mety
409	Tsy mandeha eo amin'ny mpizara ny mpisolotena vahiny QEMU
503	Nisy olana ara-pifandraisana vonjimaika. Andramo indray aorian'ny loham-pejy Retry-After.

Fafao /api/v1/servers/{uuid}/

Fafao ny mpizara

Mampidi-doha ny mpizara mankany amin'ny fafàna maharitra. Tsy hita avy hatrany ao anatin'ny lisitra ilay mpizara ka tsy azo averina.

Mila alalana: 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"
}

Kaody momba ny satan'ny valiny

202	No ekena: napetraka ho anatin'ny filaharana ilay fangatahana
404	Tsy hita, na an'ny kaonty hafa izy io

ALAO POST /api/v1/ssh-keys/

Famaha SSH

Apetrao anatin'ny kaontinao ireo famaha SSH ho an'ny daholobe, dia omeo amin'ny alalan'ny ssh_key_uuids ny uuids-ny rehefa mamorona mpizara iray ianao. Ny GET dia manisa ireo famahao (25 isaky ny pejy); ny POST dia mampiditra iray.

Mila alalana: ssh-keys:list (GET), ssh-keys:create (POST)

Fangatahana masontsivana momba ny vatana (POST)

Mpizahaky ny macro	Karazana	ilaina	Fanoritsoritana
`name`	string	ENY	Anarana ahafantarana ilay famaha, hatramin'ny marika 100
`public_key`	string	ENY	Ny famaha ho an'ny daholobe amin'ny endrika OpenSSH, ohatra ny mpiatin'ny id_ed25519.pub

Ohatra amin'ny fangatahana

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

Ohatra amin'ny Valiny

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

Saha Valiny

Field	Karazana	Fanoritsoritana
`id`, `uuid`	integer, string	Mpamantatra famaha. Ampiasao ny uuid anatin'ny ssh_key_uuids sy anatin'ny URL eto ambany; miasa ao amin'ny ssh_key_ids ny id.
`fingerprint`	string	Ny dian-tànana MD5 an'ilay famaha, nofaritan'ny sehatrasa
`last_used_at`	datetime \| null	Ny fotoana nametrahana ilay famaha farany teo amin'ny mpizara vaovao

Kaody momba ny satan'ny valiny

201	Famaha nanampy
400	Tsy misy anarana, na tsy famaha SSH mety ho an'ny daholobe ilay famaha

ALAO Fafao /api/v1/ssh-keys/{uuid}/

Maka na manafoana famaha SSH iray

Ny GET dia mandefa famaha iray miaraka amin'ireo sehatr'asa etsy ambony. Ny DELETE dia manaisotra azy amin'ny kaontinao ary mandefa 204 tsy misy vatana. Tsy manaisotra azy amin'ny mpizara efa napetraka izy io raha fafàna famaha iray. Tsy azo ovaina ny famaha: fafàna ary ampiana indray.

Mila alalana: 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"

Fandraiketana sy sary

Ny famoronana tahirin-kevitra na sary mivantana dia asa iray amin'ny mpizara ihany koa:

POST /api/v1/servers/{uuid}/backup/: API backups
POST /api/v1/servers/{uuid}/snapshot/: API Sary Misongadina

VPS.org API

API ho an'ny mpizara

Tanisao ny mpizara rehetra

Paramètres de requête

Ohatra amin'ny fangatahana

Ohatra amin'ny Valiny

Saha Valiny

Kaody momba ny satan'ny valiny

Mamoròna mpizara vaovao

Fangatahana masontsivana momba ny vatana

Ohatra amin'ny fangatahana

Ohatra amin'ny Valiny

Kaody momba ny satan'ny valiny

Makà antsipirian'ny mpizara

Ohatra amin'ny Valiny

Saha Valiny

Kaody momba ny satan'ny valiny

Maka ny toetr'ilay mpizara

Sandan'ny toetran'ny mpizara

Manara-maso ny herin'ny mpizara

Fangatahana masontsivana momba ny vatana

Ohatra amin'ny fangatahana

Ohatra amin'ny Valiny

Kaody momba ny satan'ny valiny

Hanova ny haben'ny mpizara

Fangatahana masontsivana momba ny vatana

Kaody momba ny satan'ny valiny

Reset Root Password

Kaody momba ny satan'ny valiny

DNS miverina (PTR)

Fangatahana masontsivana momba ny vatana (POST)

Kaody momba ny satan'ny valiny

Mandefa baiko amin'ny mpizara iray

Fangatahana masontsivana momba ny vatana

Kaody momba ny satan'ny valiny

Fafao ny mpizara

Kaody momba ny satan'ny valiny

Famaha SSH

Fangatahana masontsivana momba ny vatana (POST)

Ohatra amin'ny fangatahana

Ohatra amin'ny Valiny

Saha Valiny

Kaody momba ny satan'ny valiny

Maka na manafoana famaha SSH iray

Fandraiketana sy sary