VPS.org API

Litokomane tsa REST API

Sistimi ea Ts'ebetso ea API

E bonts'a li-system tsa ho sebetsa tseo u ka li kenya le li-version tsa tsona. E fetisa uuid ea mofuta e le operating_system_version_uuid ha u etsa setsi.

Mafelo a ho Qetela 2
Tsela ea Motheo /api/v1/operating-systems
FUMANA /api/v1/operating-systems/

Li-OS tsa ho kenya

E khutlisa sistimi ea ts'ebetso ka 'ngoe le litlhaku tsa eona tse sebetsang. Uluhlu ha bo na li-filters.

Litokelo li hlokahale: operating-systems:list

Kopo ea Mohlala

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

Karabo ea Mohlala

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

E khutsufalitsoe: e bonts'a sistimi e sebetsang e le 'ngoe feela' me e khutsufalitsoe ka ho hlaka SVG.

Masimo a Karabo

Setereke Mofuta Bophara
id integer Mokhatlo oa ho sebetsana le sistimi
name string Lebitso la taelo, mohlala Ubuntu kapa Debian
svg_icon string Litlhaku tsa SVG tsa logo ka har'a lebokose (ha se URL)
versions array Litlhaku tse sebetsang tseo u ka li kenyang
versions[].uuid string Senya e le operating_system_version_uuid ha o etsa setsi sa marang-rang
versions[].name string Tlhaloso le moralo, mohlala 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Lebitso le letšoao la sistimi e sebetsang ea mofuputsi
versions[].is_active boolean Na mofuta ona o ka sebelisoa ho li-server tse ncha

Likhoutu tsa Boemo ba Karabelo

200 Li-system tsa ho sebetsa li fumaneha ka katleho
403 Token ea API e sa nepahalang kapa e sa fumaneheng, kapa token e na le litokelo tse hlokahalang
FUMANA /api/v1/operating-systems/{id}/

Fumana sistimi ea ho sebetsa

E khutlisa sistimi e sebetsang e le 'ngoe le liphetoho tsa eona tse sebetsang, ka libaka tse ka holimo.

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

Likhoutu tsa Boemo ba Karabelo

200 Bophelo bo botle
404 Ha ho na sistimi ea ho sebetsana le id eo

Ho khetha mofuta

Tseba li-versions ka lebitso ha li ntse li sebetsa ho fapana le ho beha uuid ka hardcode, ka hona ho kopanngoa ha hao ho ntse ho sebetsa ha li-versions li eketsoa kapa li tlosoa. Lintlha tsa ho kena ha root li romelloa ka lengolo tsoibila ho motsamaisi oa akhaonteng ha setsi se le setšeng; eketsa konopo ea SSH ha u theha setsi ho kena ka konopo.