VPS.org API

Documentazione REST API

API di i Sistemi Operativi

Elenca i sistemi operativi ca si ponnu installari e li so versioni. Passa l'uuid di na versione comu operating_system_version_uuid quannu si crea un servituri.

Punti finali 2
Percorsu di Base /api/v1/operating-systems
OTTIENI /api/v1/operating-systems/

Lista di sistemi operativi

Ritorna ogni sistema operative cu li so versioni attivi. La lista nun havi filtri.

Permessi richiesti: operating-systems:list

Esempiu di dumanda

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

Esempiu di risposta

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

Scurtatu: si mustra sulu un sistema operative e si tagghia lu markup SVG.

Campi di risposta

Campu Tipu Descrizzioni
id integer Identificaturi dû sistema operative
name string U nomu di la distribuzzioni, pi esempiu Ubuntu o Debian
svg_icon string Marcatura SVG in linea di u logo (non un URL)
versions array Versioni attivi ca si ponnu installari
versions[].uuid string Usa comu operating_system_version_uuid quannu si crea un servituri
versions[].name string Versione e architettura, pi esempiu 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string U nomu e l'icona dû sistema operative parinte
versions[].is_active boolean Si la versione pò èssiri usata pi novi sirvizzi

Codici di Statu di Risposta

200 Lista di sistemi operativi ricivuti
403 Token API mancante o nun validu, o u token nun havi li permessi richiesti
OTTIENI /api/v1/operating-systems/{id}/

Ottieni un sistema operative

Ritorna un sistema operative e li so versioni attivi, cu li campi supra.

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

Codici di Statu di Risposta

200 Successu
404 Nudda sistema operativu cu stu id

Scegliri na virsioni

Cerca li versioni pi nomu a tempu di execuzioni anzicchì codificari un uuid, accussì la to integrazzioni continua a travagghiari quannu li versioni sunnu agghiunti o ritirati. Li dati di login di root sunnu mandati via mail ô prupitari dû contu quannu u servituri è prontu; agghiunci una chiavi SSH quannu crià u servituri pi accediri cu na chiave.