VPS.org API

REST API Xuquuqda

API-ga Nidaamyada Hawlgalka

Liiska nidaamka hawlgalka aad ku rakibi kartaa iyo noocyadooda. uuid-ka noocyada u gudbi sida operating_system_version_uuid markaad abuurto server.

Dhammaadka 2
Waddo Saldhig ah /api/v1/operating-systems
HEL /api/v1/operating-systems/

Liiska nidaamka hawlgalka

Ku soo celin doona nidaamka hawlgalka oo dhan oo leh noocyada hawlgalka. Liiska ma laha filters.

Xuquuqda loo baahan yahay: operating-systems:list

Codsi Tusaale ah

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

Jawaabta Tusaale

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

La gaabiyey: kaliya hal nidaamka hawlgalka ayaa la muujiyey oo SVG markup waa la go'ay.

Goobaha Jawaabta

Isku-darka Nooca Tilmaamaha
id integer Tusaale:
name string Magaca qaybinta, tusaale ahaan Ubuntu ama Debian
svg_icon string Inline SVG markup of the logo (aan URL ahayn)
versions array noocyada hawlgalka ah ee aad ku rakibi karto
versions[].uuid string isticmaal sida operating_system_version_uuid markaad abuurayso server
versions[].name string Nooca iyo dhismaha, tusaale ahaan 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Magaca iyo astaanta nidaamka hawlgalka hooyada
versions[].is_active boolean In noocyada la isticmaali karo servers cusub

Koodhadhka Xaaladda Jawaab celinta

200 Liiska nidaamka hawlgalka oo si guul leh loo soo celiyay
403 Xiran ama aan sharci ahayn API token, ama token ka maqan oggolaanshaha loo baahan yahay
HEL /api/v1/operating-systems/{id}/

Ka hel nidaamka hawlgalka

Ku soo laabtaa mid ka mid ah nidaamka qalliinka iyo noocyada ay hawlgalaan, oo leh meelaha kor ku xusan.

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

Koodhadhka Xaaladda Jawaab celinta

200 Guul
404 Ma jiro nidaam hawlgelin oo leh id-kaas

Doorashada Version

Fiiri noocyada kor ku magac runtime ka dib markii uu hardcoding uuid, sidaas darteed integration aad sii wadaan inay shaqeeyaan marka noocyada la kordhiyay ama ka tagay. Root login faahfaahinta waxaa emailed in account owner marka server waa diyaar; ku dar SSH key marka ay abuuraan server in ay galaan keyd ka dhigan.