VPS.org API

@ action

API na Tsarin Aiki

Ka yi jerin tsarin aiki da zaka iya shigar da su da kuma nau'ukansu. Ka mika uuid na nau'i kamar operating_system_version_uuid idan ka ƙirƙiri wani mai masaukin yanar gizo.

Ƙarshen maki 2
Hanyar Tushe /api/v1/operating-systems
SAMU /api/v1/operating-systems/

Jerin tsarin aiki

Returns each operating system with its active versions. The list has no filters.

Required permission: operating-systems:list

Buƙatar Misali

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

Misalin Amsar

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

An rage: an nuna tsarin aiki guda kawai kuma an yanke alamar SVG.

Wuraren Amsawa

@ action Nau'i @ action
id integer Mai gane tsarin aiki
name string Sunan rabawa, misali Ubuntu ko Debian
svg_icon string Inline SVG markup na alamar (ba URL ba)
versions array Nau'in da za ka iya shigarwa
versions[].uuid string Yi amfani da shi kamar tsarin_aiki_fari_uuid lokacin da ake ƙirƙirar mai masaukin
versions[].name string Nau'in da kuma tsarin, misali 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Sunan da alamar alamar tsarin aiki na mahaifi
versions[].is_active boolean Ko za'a iya amfani da wannan sigar ga masu ba da sabis na sabon

Lambobin Matsayin Amsawa

200 An samu jerin tsarin aiki da aka samu da nasara
403 An rasa ko kuma an karya tabbacin API, ko kuma tabbacin bai da izinin da ake bukata
SAMU /api/v1/operating-systems/{id}/

Ka Samu Wani Shirin Aiki

Mai mayar da tsarin aiki guda da nau'ikansa masu aiki, tare da fannoni a sama.

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

Lambobin Matsayin Amsawa

200 Success
404 Babu tsarin aiki da wannan shaidar

Picking a Version

Ka duba wayoyin da aka yi amfani da su bisa sunansu a lokacin tafiyar da shi, ba tare da yin ƙoƙarin yin uuid ba, don haka haɗinka zai ci gaba da aiki idan an ƙara wayoyin ko kuma aka cire su. An aika da bayanin shiga na ƙanshin zuwa mai asusun ta hanyar imel idan mai wayoyin ya yi aiki; ƙara maɓallin SSH lokacin da kake ƙirƙirar mai wayoyin don shiga da maɓallin a maimakon haka.