VPS.org API

РЕСТЕПНА АПИ документација

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

Наброји операционе системе које можете инсталирати и њихове верзије. Пошаљите уид верзије као операциони_ 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
        }
      ]
    }
  ]
}

Скраћено: приказан је само један оперативни систем и СВГ маркирање.

Поља за одговор

Поље Тип Опис
id integer Идентификатор операционог система
name string Име дистрибуције, на пример Убунута или Дебиана
svg_icon string Ун› ијежено СВГ означавање логоа (не УРЛ)
versions array Активне верзије које можете инсталирати
versions[].uuid string Користи као операциони_ систем_ верзија_ uuid при стварању сервера
versions[].name string Верзија и архитектура, на пример 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Име и икона родитељског оперативног система
versions[].is_active boolean Да ли верзија може да се користи за нове сервере

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

200 Списак оперативних система успешно добављен
403 Недостаје или неисправан АПИ торент, или неисправна дозвола недостаје
ДОБИЈ /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 Нема операционог система са тим ИД‐ ом

Избор верзије

Потражи верзије по имену у покретању уместо хардкодирање ууида, тако да ваша интеграција наставља да ради када се верзије додају или пензионишу. Детаљи пријављивања корена се шаљу пошто је сервер спреман; додајте ССХ кључ при стварању сервера да се пријави са кључем.