API-и серверҳо

ГИРЕД /api/v1/servers/

Рӯйхати ҳамаи серверҳо

Серверҳои дар ҳисоби шумо бударо бар мегардонад, аввал навтарин, 25 дар як саҳифа. Серверҳои нобудшуда дар бар гирифта намешаванд.

Иҷозат лозим аст: servers:list

Параметрҳои дархост

& Параметрҳо	Навъ	Ҳатмӣ	& Тасвирот
`page`	integer	& Намоиши хатҳои равон	Рақами саҳифа, аз 1 сар карда
`page_size`	integer	& Намоиши хатҳои равон	Натиҷаҳо дар як саҳифа (бо нобаёнӣ 25, максимум 100)

Намунаи дархост

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

Намунаи посух

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

Майдонҳои посух

& Файл	Навъ	& Тасвирот
`uuid`	string	Идентификатори сервер, ки дар ҳар нуқтаи охирини сервер истифода мешавад
`hostname`	string	Номи соҳиб, ки шумо ҳангоми эҷоди сервер интихоб кардед
`status`	string	Ҳолати ҷорӣ. Ба поёнтар ба Қимматҳои Ҳолати Сервер нигаред.
`error_description`	string \| null	Тафсилоти хатои охирин, вақте ки ҳолати хато аст, дар дигар ҳолат нуқсон
`location_name`	string	Name of the location the server runs in
`os_name`	string	Номи системаи оператсионӣ, бе версия
`plan_name`	string	Тақвими хондашавандаи ҷамъбаст, масалан 1 vCPU / 2 GB RAM / 10 GB
`ipv4_addresses`	array	Суроғаҳои IPv4 ҳамчун сатрҳо. То он даме, ки сервер насб карда шавад, холӣ аст, ва дар нақшаҳо бе IPv4.
`ipv6_addresses`	array	Суроғаҳои IPv6 ҳамчун сатрҳо. То он даме, ки сервер насб карда шавад, холӣ монед.
`created_at`	datetime	Вақти эҷод (ISO 8601, UTC)
`deployed`	boolean	Ҳақиқӣ вақте ки таъминот ба итмом расид

Рамзҳои ҳолати посух

200	Рӯйхати серверҳо бомуваффақият гирифта шуд
403	API-и нодуруст ё гумшуда ё иҷозатномаи лозимӣ барои token нест

БОЗ /api/v1/servers/

Сервери нав эҷод кунед

Сервери навро барои ҷойгиркунӣ дар навбатӣ мегузорад ва онро бо навбати ҳолати худкор бармегардонад. Дар замина таъминот идома меёбад: ҳолати ниҳоии нуқтаи охирро то ҷойгиркунӣ пурсидан то он даме, ки ҳақиқат бошад. Вақте ки сервер омода аст, маълумоти воридшавӣ ба соҳибони ҳисобҳо фиристода мешавад.

Шумо бояд усули пардохтро нигоҳ доред. Вобаста ба таърихи ҳисоб, пеш аз эҷоди сервер, муваққатан аз рӯи корти шумо маблағи як ҳафтаи нақшаи нарх (на камтар аз 1 доллари ИМА) барои пешакӣ тасдиқ намудани ҳаққи истифодаи корт нигоҳ дошта мешавад.

Иҷозат лозим аст: servers:create

Дархости параметрҳои бадан

& Параметрҳо	Навъ	Ҳатмӣ	& Тасвирот
`hostname`	string	Бале	На камтар аз 3 аломат. Танҳо ҳарфҳо, рақамҳо, пайвандҳо ва нуқтаҳо.
`location_id`	integer	Бале	ID-и ҷойгиршавии фаъол аз API-и ҷойгиршавӣ
`plan_uuid`	string	Бале	uuid нақшаи фаъол аз API- и нақшаҳо
`operating_system_version_uuid`	string	Бале	uuid-и вориди фаъол дар рӯйхати версияҳои системаи оператсионӣ
`ssh_key_uuids`	array	& Намоиши хатҳои равон	UUID-ҳои калидҳои SSH аз API-и калидҳои SSH барои насб кардан дар сервер
`ssh_key_ids`	array	& Намоиши хатҳои равон	Идентификатори рақами пурраи калидҳои SSH, ҳамчун алтернативаи ssh_key_uuids. Агар ҳарду фиристода шаванд, ssh_key_ids истифода мешавад.
`ssh_key_uuid`, `ssh_key_id`	string, integer	& Намоиши хатҳои равон	Миёнбур барои калиди ягонаи SSH
`auth_method`	string	& Намоиши хатҳои равон	гузарвожа, калиди_ssh ё ҳарду. Пешфарз барои гузарвожа ё ҳарду, вақте ки калидҳои SSH дода мешаванд.

Намунаи дархост

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

Намунаи посух

201 Эҷод карда шуд бо объектҳои пурраи сервер, ки дар Get Server Details тавсиф шудааст. Адресҳо ва 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": []
}

Рамзҳои ҳолати посух

201	Сервер эҷод карда шуд ва барои ҷойгиркунӣ дар навбат гузошта шуд
400	Хатои санҷиш, масалан, макони ғайрифаъол, нақша ё версияи системаи оператсионӣ
402	Ягон усули пардохт дар файл нест, ҳисобҳои пардохтнашуда ё иҷозатномаи пешакии корт рад карда шуд
403	API-и нодуруст ё гумшуда ё иҷозатномаи лозимӣ барои token нест
429	Шумораи ҳисобҳои шумо ба ҳадди эҷоди сервер расидааст

ГИРЕД /api/v1/servers/{uuid}/

Маълумоти серверро гиред

Як серверро бо ҷойгиршавии он, нақша, системаи оператсионӣ, суроғаҳои IP ва панҷ амали охирин бар мегардонад.

Иҷозат лозим аст: servers:list

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

Намунаи посух

{
  "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 нишонаи нишона ва рӯйхати версияҳо дар ин ҷо кӯтоҳ карда шудаанд.

Майдонҳои посух

& Файл	Навъ	& Тасвирот
`vmid`	integer \| null	Рақами мошини виртуалӣ, ки дар вақти насбкунӣ муайян шудааст
`location`	object	Объекти ҷойгиршавӣ, тавре ки аз ҷониби API-и ҷойгиршавӣ бармегардад
`plan`	object	Объекти нақша, тавре ки аз ҷониби API-и нақша баргардонида шудааст
`operating_system`, `operating_system_version`	object	Системаи оператсионӣ ва версияи насбшуда, тавре ки аз ҷониби API-и Системаҳои оператсионӣ баргардонида шудааст
`ipv4_addresses`, `ipv6_addresses`	array	Як объект барои ҳар як суроға бо ip, гузаргоҳ, зершабак ва rdns (номи соҳиб DNS- и баръакс)
`recent_actions`	array	То панҷ амали охирин: id, action, action_display, description, user_email, created_at

Рамзҳои ҳолати посух

200	Тафсилоти сервер бомуваффақият гирифта шуд
404	Ё ки ёфт нашуд ё ба ҳисоби дигар тааллуқ дорад

ГИРЕД /api/v1/servers/{uuid}/status/

Қабули вазъияти сервер

Зангзании сабук барои пурсиш баъд аз эҷод, ба кор даровардани ё тағйир додани андозаи сервер.

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
}

Ҳолати сервер

& Маънӣ	& Тасвирот
`queue`	An action (deploy, power, resize, restore) is queued or in progress
`deploying`	Дар ҳоли омодагӣ. Серверҳои аз панели идоракунӣ сохташуда ин ҳолати истифодабарӣ мекунанд; серверҳои аз API сохташуда то омодагӣ дар навбат мемонанд.
`on`	Иҷро шуда истодааст
`off`	Хомӯш карда шуд
`error`	Амали охирин қатъ карда шуд. Ба error_description нигаред.
`suspended_payment`	Дар ҳоли боздоштан аз сабаби ҳисоботи пардохтнашуда

БОЗ /api/v1/servers/{uuid}/power/

Идоракунии барқии сервер

Дар навбати амали барқӣ. Ҳолати сервер ба навбатӣ тағйир меёбад, то он даме, ки амал ба итмом расад.

Иҷозат лозим аст: servers:power

Дархости параметрҳои бадан

& Параметрҳо	Навъ	Ҳатмӣ	& Тасвирот
`action`	string	Бале	`start`: барқ `shutdown`: хомӯшкунии олиҷаноб, агар меҳмон хомӯш нашавад, маҷбурӣ хомӯш мешавад `restart`: давраи барқии сахт (истифодаи барқро қатъ кунед, баъд оғоз кунед) `stop`: дар айни замон ҳамон як давраи барқро иҷро мекунад, ки аз нав оғоз кардан. Барои хомӯш кардани сервер shutdown- ро истифода баред.

Намунаи дархост

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

Намунаи посух

{
  "message": "Server restart queued"
}

Рамзҳои ҳолати посух

200	Амал дар навбат гузошта шуд
400	Амалиёти нопадид ё пуштибонӣ нашуда
402	оғози рад карда шуд, зеро ҳисобот ҳисобҳои пардохтнашуда дорад
404	Ё ки ёфт нашуд ё ба ҳисоби дигар тааллуқ дорад

БОЗ /api/v1/servers/{uuid}/resize/

Тағйири андозаи сервер

Серверро ба нақшаи дигари фаъол гузаронед. Нақшаи нав наметавонад фазои диски камтар аз нақшаи ҷорӣ дошта бошад, ва дархости бадан бояд амали барои тағйир додани андоза дошта бошад. Қадри гипервизор барои нақшаи нав пеш аз он, ки ягон чиз дар навбат гузошта шавад, санҷида мешавад, аз ин рӯ дархости радшуда серверро тағйир намедиҳад.

Сервер дар вақти тағйир додани андоза хомӯш карда мешавад ва баъд аз нав оғоз меёбад. Агар тағйир додани андоза ноком шавад, сервер ба нақшаи пешина бармегардад ва аз нав оғоз меёбад, агар он кор мекард. Диски калоншуда барҳам дода намешавад.

Иҷозат лозим аст: servers:resize

Дархости параметрҳои бадан

& Параметрҳо	Навъ	Ҳатмӣ	& Тасвирот
`action`	string	Бале	Андозаи нав кардан лозим аст
`new_plan_uuid`	string	Бале	Утилита барои сохтани нақшаи гузариш

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

Мисол барои тағйир додани андозаи радшуда (409):

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

Рамзҳои ҳолати посух

200	Амал дар навбат гузошта шуд
400	Амалиёт ё new_plan_uuid-и гумшуда, нақшаи нодуруст ё ғайрифаъол, нақша бо фазои диски кам ё нақшаи GPU (планҳои GPU-ро бо API тағйир додан мумкин нест)
404	Ё ки ёфт нашуд ё ба ҳисоби дигар тааллуқ дорад
409	Тағйири андоза ё нигоҳдории тағйирот аллакай дар раванд аст, ё барои нақшаи нав иқтидори кофии гипервизор вуҷуд надорад
503	Ҳолати ҳозира имконпазирӣ санҷида намешавад. Сервер тағйир наёфтааст; баъдтар боз кӯшиш кунед.

БОЗ /api/v1/servers/{uuid}/reset-password/

Бозсозии гузарвожаи root

Пароли нави root- ро эҷод мекунад, онро дар ҷавоб бармегардонад ва дар сервери дигаргуншуда дар навбат мегузорад. Пароли нав ба шумо бо почтаи электронӣ низ фиристода мешавад. Сервер бояд истифода шавад. Дархости ҷисмонӣ лозим нест.

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

Рамзҳои ҳолати посух

200	Амал дар навбат гузошта шуд
400	Сервер ҳанӯз насб нашудааст
404	Ё ки ёфт нашуд ё ба ҳисоби дигар тааллуқ дорад

ГИРЕД БОЗ /api/v1/servers/{uuid}/rdns/

DNS- и баръакс (PTR)

GET номи DNS- и бозгашти соҳибро барои ҳар як IPv4 ва IPv6 суроға дар сервер рӯйхат мекунад. POST онро барои як суроға барпо мекунад. Фиристодани номи холии соҳиб суроғаро ба номи DNS- и бозгашти пешфарз бармегардонад.

Иҷозат лозим аст: servers:update

Дархости параметрҳои бадан (POST)

& Параметрҳо	Навъ	Ҳатмӣ	& Тасвирот
`ip`	string	Бале	Суроғаи IPv4 ё IPv6 ба ин сервер таъин шудааст
`hostname`	string	& Намоиши хатҳои равон	Номи соҳиб PTR. Хомӯш гузоред барои барқарорсозии пешфарз.

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:

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

Рамзҳои ҳолати посух

400	ip- и нодуруст ё номи соҳиб насб карда нашуд
404	Адреси IP ба ин сервер таъин нашудааст

БОЗ /api/v1/servers/{uuid}/exec/

Иҷрои фармон дар сервер

Иҷрои фармони муҳр дар сервер тавассути агенти меҳмони QEMU ва интизори анҷоми он. Сервер бояд насб шуда бошад ва кор кунад, ва qemu- guest- agent бояд насб шуда бошад ва дар меҳмон кор кунад.

Иҷозат лозим аст: servers:exec

Дархости параметрҳои бадан

& Параметрҳо	Навъ	Ҳатмӣ	& Тасвирот
`command`	string	Бале	Дар сатри фармон бо /bin/sh -c иҷро кунед, то 2000 аломат
`timeout`	integer	& Намоиши хатҳои равон	Сонияҳои интизори фармон, аз 1 то 300 (бо нобаёнӣ 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
}

Агар фармон ҳанӯз иҷро шуда истодааст, вақте ки мӯҳлати интизорӣ ба итмом мерасад, ҷавоб timed_out ба true ва exit_code ба null насб карда мешавад.

Рамзҳои ҳолати посух

200	Фармон ба итмом расид ё вақти таъиншуда ба итмом расид
400	Сервер не развернут или не запущен, или параметры неверны
409	Агенти меҳмони QEMU дар сервер иҷро намешавад
503	Муваққатан пайвастшавӣ мушкил аст. Пас аз сарлавҳаи Retry- After боз кӯшиш кунед.

НЕСТ КАРДАН /api/v1/servers/{uuid}/

Серверро нест кунед

Серверро барои нобудкунии доимӣ дар навбат мегузорад. Сервер аз рӯйхат беихтиёр нест мешавад ва барқарор карда намешавад.

Иҷозат лозим аст: 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"
}

Рамзҳои ҳолати посух

202	Қабул шуд: дархости дар навбат гузошта шуд
404	Ё ки ёфт нашуд ё ба ҳисоби дигар тааллуқ дорад

ГИРЕД БОЗ /api/v1/ssh-keys/

Калидҳои SSH

Калидҳои SSH-и оммавиро дар ҳисоби худ нигоҳ доред, сипас ҳангоми эҷоди сервер uuids-и онҳоро ҳамчун ssh_key_uuids гузаронед. GET калидҳои шуморо дар рӯйхат нишон медиҳад (25 дар як саҳифа); POST якеро илова мекунад.

Иҷозат лозим аст: ssh-keys:list (GET), ssh-keys:create (POST)

Дархости параметрҳои бадан (POST)

& Параметрҳо	Навъ	Ҳатмӣ	& Тасвирот
`name`	string	Бале	Номи калид барои шинохти калид, то 100 аломат
`public_key`	string	Бале	Калиди кушод дар формати OpenSSH, масалан, мундариҷаи id_ed25519.pub

Намунаи дархост

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

Намунаи посух

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

Майдонҳои посух

& Файл	Навъ	& Тасвирот
`id`, `uuid`	integer, string	Идентификатори калидҳо. Дар ssh_key_uuids ва дар URL-и поён истифода баред; id дар ssh_key_ids кор мекунад.
`fingerprint`	string	MD5-и калид, ки аз тарафи платформа ҳисоб карда шудааст
`last_used_at`	datetime \| null	Вақти охирин бор насб кардани калид дар сервери нав

Рамзҳои ҳолати посух

201	Калид илова карда шуд
400	Номи нодуруст ё калиди кушода калиди кушодаи SSH-и дуруст нест

ГИРЕД НЕСТ КАРДАН /api/v1/ssh-keys/{uuid}/

Гирифтан ё нест кардани калиди SSH

GET калиди якумро бо майдонҳои дар боло буда бармегардонад. DELETE онро аз ҳисоби шумо тоза мекунад ва 204- ро бе ҷисм бармегардонад. Ҳузфи калид онро аз серверҳое, ки аллакай дар онҳо насб карда шудааст, тоза намекунад. Калидҳо таҳрир карда намешаванд: нест карда шуда ва аз нав илова карда мешаванд.

Иҷозат лозим аст: 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"

Захираи нусхаи эҳтиётӣ ва суратҳо

Эҷоди нусхаи эҳтиётӣ ё сурати экран низ амали сервер аст:

POST /api/v1/servers/{uuid}/backup/: API-и нусхабардорӣ
POST /api/v1/servers/{uuid}/snapshot/: API-и аксҳои снэпшотӣ

VPS.org API

API-и серверҳо

Рӯйхати ҳамаи серверҳо

Параметрҳои дархост

Намунаи дархост

Намунаи посух

Майдонҳои посух

Рамзҳои ҳолати посух

Сервери нав эҷод кунед

Дархости параметрҳои бадан

Намунаи дархост

Намунаи посух

Рамзҳои ҳолати посух

Маълумоти серверро гиред

Намунаи посух

Майдонҳои посух

Рамзҳои ҳолати посух

Қабули вазъияти сервер

Ҳолати сервер

Идоракунии барқии сервер

Дархости параметрҳои бадан

Намунаи дархост

Намунаи посух

Рамзҳои ҳолати посух

Тағйири андозаи сервер

Дархости параметрҳои бадан

Рамзҳои ҳолати посух

Бозсозии гузарвожаи root

Рамзҳои ҳолати посух

DNS- и баръакс (PTR)

Дархости параметрҳои бадан (POST)

Рамзҳои ҳолати посух

Иҷрои фармон дар сервер

Дархости параметрҳои бадан

Рамзҳои ҳолати посух

Серверро нест кунед

Рамзҳои ҳолати посух

Калидҳои SSH

Дархости параметрҳои бадан (POST)

Намунаи дархост

Намунаи посух

Майдонҳои посух

Рамзҳои ҳолати посух

Гирифтан ё нест кардани калиди SSH

Захираи нусхаи эҳтиётӣ ва суратҳо