VPS.org API

Dokumentazzjoni tal-REST API

API tas-Sistemi Operattivi

Lista tas-sistemi operattivi li inti tista tinstalla u l-verżjonijiet tagħhom. Pass verżjoni uuid bħala operating_system_version_uuid meta toħloq server.

Punti tat-tmiem 2
Mogħdija Bażika /api/v1/operating-systems
IKSEB /api/v1/operating-systems/

Lista Sistemi Operattivi

Jirritorna kull sistema operattiva mal-verżjonijiet attivi tagħha. Il-lista ma jkollha l-ebda filtri.

Permess meħtieġ: operating-systems:list

Eżempju ta' Talba

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

Eżempju ta' Rispons

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

Imqassar: sistema operattiva waħda biss tintwera u l-marka SVG titqatta'.

Oqsma ta' Rispons

Qasam Tip Deskrizzjoni
id integer Identifikatur tas-sistema operattiva
name string Isem id-distribuzzjoni, pereżempju Ubuntu jew Debian
svg_icon string Inline SVG markup tal-logo (mhux URL)
versions array Verżjonijiet attivi li tista' tinstalla
versions[].uuid string Uża bħala operating_system_version_uuid meta toħloq server
versions[].name string Verżjoni u l-arkitettura, per eżempju 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Isem u icon tas-sistema operattiva prinċipali
versions[].is_active boolean Jekk il-verżjoni tistax tintuża għal servers ġodda

Kodiċijiet tal-Istatus tar-Rispons

200 Lista ta' sistemi operattivi li nġabru b'suċċess
403 Token tal-API nieqes jew invalidu, jew it-token ma għandux il-permess meħtieġ
IKSEB /api/v1/operating-systems/{id}/

Ikseb Sistema Operattiva

Jirritorna sistema operattiva waħda u l-verżjonijiet attivi tagħha, bl-oqsma hawn fuq.

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

Kodiċijiet tal-Istatus tar-Rispons

200 Suċċess
404 L-ebda sistema operattiva b'dak id

Picking a Verżjoni

Fittex verżjonijiet bl-isem fil-ħin tal-runtime minflok hardcoding uuid, sabiex l-integrazzjoni tiegħek tibqa taħdem meta verżjonijiet huma miżjuda jew rtirati. Root login dettalji huma emailed lill-proprjetarju tal-kont ladarba s-server huwa lest; żid SSH ewlenija meta toħloq is-server biex log fil ma ċavetta minflok.