VPS.org API

API- документација

API за оперативни системи

Ги набројува оперативните системи кои можете да ги инсталирате и нивните верзии. Подај ги ууид верзиите како operating_ system_ version_ uuid кога ќе креирате сервер.

Крајни точки 2
Основна патека /api/v1/operating-systems
ДОБИЈ /api/v1/operating-systems/

Листа на оперативни системи

Враќа секој оперативен систем со активни верзии. Листата нема филтри.

Неопходна дозвола: operating-systems:list

Пример за барање

cURL
Python
JavaScript
curl -X GET "https://admin.vps.org/api/v1/operating-systems/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
import requests

url = "https://admin.vps.org/api/v1/operating-systems/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for os_entry in response.json()["results"]:
    for version in os_entry["versions"]:
        print(os_entry["name"], version["name"], version["uuid"])
const response = await fetch('https://admin.vps.org/api/v1/operating-systems/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
for (const os of data.results) {
  for (const version of os.versions) {
    console.log(os.name, version.name, version.uuid);
  }
}

Пример за одговор

{
  "count": 6,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 1,
      "name": "Ubuntu",
      "svg_icon": "<svg ...>",
      "versions": [
        {
          "uuid": "2fdead8f-81a2-4a23-9a81-0cf969fe1266",
          "name": "22.04 LTS x64",
          "os_name": "Ubuntu",
          "os_svg_icon": "<svg ...>",
          "is_active": true
        },
        {
          "uuid": "c3418f90-80a0-4e00-a7e1-d0ab1822b941",
          "name": "24.04 LTS x64",
          "os_name": "Ubuntu",
          "os_svg_icon": "<svg ...>",
          "is_active": true
        }
      ]
    }
  ]
}

Скратено: Прикажан е само еден оперативен систем и SVG-позицијата е сечена.

Полиња за одговор

Поле Тип Опис
id integer Идентификатор на оперативниот систем
name string Име на дистрибуција, на пример Ubuntu или Debian
svg_icon string Внатрешно SVG означување на логото (не е URL)
versions array Активни верзии што можете да ги инсталирате
versions[].uuid string Користи како operating_system_version_uuid при креирање на сервер
versions[].name string Верзија и архитектура, на пример 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Име и икона на родителскиот оперативен систем
versions[].is_active boolean Дали верзијата може да се користи за нови сервери

Кодови за статус на одговор

200 Листата на оперативни системи е успешно дофатена
403 Недостасува или невалиден API- токен, или на токму тоа му недостига потребната дозвола
ДОБИЈ /api/v1/operating-systems/{id}/

Оперативниот систем

Враќа еден оперативен систем и неговите активни верзии, со полињата горе.

curl -X GET "https://admin.vps.org/api/v1/operating-systems/1/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Кодови за статус на одговор

200 Успех
404 Нема оперативен систем со тој ид.

Избирање верзија

Барајте верзии по име во извршното време наместо да кодирате хардкодирање на uuid, така што вашата интеграција продолжува да работи кога верзиите се додаваат или пензионирани. Деталите за коренот се испраќаат на сопственикот на сметката откако ќе биде подготвен серверот; додавајте SSH- тастер при создавањето на серверот за да се најавите со клуч.