VPS.org API

Dokumentimi i API REST

API-ja e Sistemeve Operative

Liston sistemet operativë që mund të instaloni dhe versionet e tyre. Paso uuid të një versioni si operating_system_version_uuid kur krijon një server.

Pikat fundore 2
Shtegu Bazë /api/v1/operating-systems
MERR /api/v1/operating-systems/

Lista e sistemeve operativë

Kthen çdo sistem operativ me versionet e tij aktive. Lista nuk ka filtra.

Të drejta të nevojshme: operating-systems:list

Shembull Kërkese

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

Shembull Përgjigjeje

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

Shkurtuar: vetëm një sistem operativ është shfaqur dhe SVG markup është prerë.

Fushat e Përgjigjes

Fusha Lloji Përshkrimi
id integer Identifikuesi i sistemit operativ
name string Emri i shpërndarjes, për shembull Ubuntu ose Debian
svg_icon string Shënim SVG i brendshëm i logos (jo URL)
versions array Versionet aktive që mund të instaloni
versions[].uuid string Përdor si operating_system_version_uuid kur krijon një server
versions[].name string Versioni dhe arkitektura, për shembull 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Emri dhe ikonë e sistemit operativ prindëror
versions[].is_active boolean Nëse versioni mund të përdoret për serverat e rinj

Kodet e Statusit të Përgjigjes

200 Lista e sistemeve operativë u mor me sukses
403 Token i munguar apo i pavlefshëm API, ose token nuk ka të drejtat e kërkuara
MERR /api/v1/operating-systems/{id}/

Merr një sistem operativ

Kthen një sistem operativ dhe versionet e tij aktive, me fushat e mësipërme.

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

Kodet e Statusit të Përgjigjes

200 Suksesi
404 Asnjë sistem operativ me këtë ID

Zgjedhja e një versioni

Kërko versionet sipas emrit në kohën e ekzekutimit në vend të kodifikimit të uuid, kështu që integrimi juaj vazhdon të funksionojë kur versionet shtohen apo hiqen. Detajet e hyrjes root dërgohen me email tek pronari i llogarisë sapo serveri të jetë gati; shto një kyç SSH kur krijon serverin për të hyrë me një kyç në vend të tij.