VPS.org API

REST API dokumentacija

API operativnih sustava

Navedite operativne sustave koje možete instalirati i njihove verzije. Dodajte uuid verzije kao operating_system_version_uid kada kreirate poslužitelj.

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

Popis operativnih sustava

Vraća svaki operativni sustav sa svojim aktivnim verzijama. Lista nema filtere.

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

Skrateno: prikazuje se samo jedan operativni sustav i SVG označavanje je rezano.

Polja za odgovor

Polje Tip Opis
id integer Identifikator operativnog sustava
name string Ime distribucije, primjerice Ubuntu ili Debian
svg_icon string SVG oznaka logotipa (nije URL)
versions array Aktivne verzije koje možete instalirati
versions[].uuid string Koristi kao operating_system_version_uuid pri stvaranju poslužitelja
versions[].name string Verzija i arhitektura, primjerice 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Ime i ikona roditeljskog operativnog sustava
versions[].is_active boolean Može li se koristiti inačica za nove poslužitelje

Kodovi statusa odgovora

200 Popis operativnih sustava uspješno dobavljen
403 Nedostaje ili neispravan API žeton, ili token nedostaje potrebna dozvola
DOBITI /api/v1/operating-systems/{id}/

Nabavi operativni sustav

Vraća jedan operativni sustav i njegove aktivne verzije, s 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 sustava s tim ID-om

Odabir verzije

Potražite verzije po imenu na pokretanju umjesto hardcoding uuid, tako da vaša integracija nastavi raditi kada se verzije dodaju ili umirovljene. Root prijava podaci su e-mailom vlasniku računa nakon što je poslužitelj spreman; dodajte SSH ključ prilikom stvaranja poslužitelja za prijavu s ključem umjesto toga.