VPS.org API

REST API dokumentacija

API operativnih sistema

Popis operacijskih sistema koje možete instalirati i njihove verzije. Proslijedite uuid verzije kao operating_system_version_uuid kada napravite server.

Krajnje tačke 2
Osnovni put /api/v1/operating-systems
DOBITI /api/v1/operating-systems/

Operativni sistemi

Vraća svaki operativni sistem sa njegovim aktivnim verzijama. Spisak nema filtra.

Potrebna dozvola: operating-systems:list

Primjer zahtjeva

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

Primjer odgovora

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

Skraćeno: prikazan je samo jedan operativni sistem, a SVG oznaka je izrezana.

Polja za odgovor

Polje Tip Opis
id integer Operativni sistem
name string Ime distribucije, naprimjer Ubuntu ili Debian
svg_icon string Ugrađeni SVG oznake logotipa (ne URL)
versions array Aktivne verzije koje možete instalirati
versions[].uuid string Koristi kao operativni_sistem_verzija_uuid pri stvaranju servera
versions[].name string Verzija i arhitektura, na primjer 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Ime i ikona nadređenog operativnog sistema
versions[].is_active boolean Da li se verzija može koristiti za nove servere

Kodovi statusa odgovora

200 Uspješno preuzeta lista operativnih sistema
403 Nedostaje ili nije valjan API token, ili token nema potrebne dozvole
DOBITI /api/v1/operating-systems/{id}/

Operativni sistem

Vraća jedan operativni sistem i njegove aktivne verzije, sa poljima iznad.

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

Kodovi statusa odgovora

200 Uspjeh
404 Nema operativnog sistema sa tim ID-om

Odabir verzije

Traži verzije po imenu tokom izvođenja umjesto hardkodiranja uuid-a, tako da vaša integracija nastavi raditi kada se verzije dodaju ili povuku. Detalji root prijave se šalju vlasniku računa pošto server bude spreman; dodajte SSH ključ prilikom stvaranja servera da se prijavite sa ključem umjesto toga.