VPS.org API

REST API Documentation

API yeMasisitimu Ekushanda

Kuisa masystem ekushandisa aungaisa pamwe neshanduro dzavo. Pasa uuid yeshanduro seoperating_system_version_uuid kana uchigadzira server.

Magumo 2
Nzira Yekutanga /api/v1/operating-systems
Tora /api/v1/operating-systems/

Kuisa Operating Systems

Inodzosera ese masystem ekushandisa neanoshanda mavhezheni ayo. Iyo list haina zvishongedzo.

Kuda mvumo: operating-systems:list

Muenzaniso weChikumbiro

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

Muenzaniso weMhinduro

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

Yakavharwa: imwe chete operating system inoratidza uye SVG markup inovharwa.

Minda Yemhinduro

_Firi Rudzi Kutaura
id integer Operating system identifier
name string Zita redistribution, semuenzaniso Ubuntu kana Debian
svg_icon string Inline SVG markup yelogo (hachisi URL)
versions array Active versions iwe unogona kuisa
versions[].uuid string Usashandisa se operating_system_version_uuid kana uchigadzira server
versions[].name string Version uye architecture, semuenzaniso 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Zita ne icon yemubereki operating system
versions[].is_active boolean Kana iyo vhezheni ichigona kushandiswa kune nyowani servers

Makodhi eMamiriro eMhinduro

200 Kubudirira kudzoreredza operating system list
403 Kukanganisa kweAPI Token kana kuti Token haina mvumo yakakodzera
Tora /api/v1/operating-systems/{id}/

Kuwana Operating System

Rega imwe operating system uye yayo anoshanda zvinyorwa, nenzvimbo pamusoro.

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

Makodhi eMamiriro eMhinduro

200 Kubudirira
404 Hapana operating system ine iyo id

Kusarudza Version

Kutsvaga zvinyorwa nezita panguva yekushanda, kwete ne hardcoding uuid, saka kubatanidzwa kwako kunoramba kuchishanda kana zvinyorwa zvawedzerwa kana kudzokera. Root login details are emailed to the account owner once the server is ready; add a SSH key when creating the server to log in with a key instead.