VPS.org API

REST API dokumentasyon

API ng mga Operating System

Listahan ng mga operating system maaari mong i-install at ang kanilang mga bersyon. Magpasa ng isang bersyon ng uuid bilang operating_system_version_uuid kapag lumikha ka ng isang server.

Mga Endpoint 2
Landas ng Batayan /api/v1/operating-systems
KUMUHA /api/v1/operating-systems/

Listahan ng mga Operating Systems

Bumalik bawat operating system na may mga aktibong bersyon nito. Ang listahan ay walang filter.

Kailangang pahintulot: operating-systems:list

Halimbawang Kahilingan

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

Halimbawang Tugon

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

Ang mga sumusunod ay mga halimbawa: Ang isang sistemang kontrol ay isang sistemang kontrol na may isang kontroler.

Mga Patlang ng Tugon

Patlang Uri Paglalarawan
id integer Operating system identifier
name string Distribution pangalan, halimbawa Ubuntu o Debian
svg_icon string Inline SVG markup ng logo (hindi isang URL)
versions array Aktibong bersyon maaari mong i-install
versions[].uuid string Gamitin bilang operating_system_version_uuid kapag lumilikha ng isang server
versions[].name string Versiyon at arkitektura, halimbawa 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Pangalan at icon ng magulang operating system
versions[].is_active boolean Kung ang bersyon ay maaaring gamitin para sa mga bagong server

Mga Kodigo ng Katayuan ng Tugon

200 Matagumpay na nakuha operating system listahan
403 Walang o hindi wastong API token, o ang token ay kulang ang kinakailangang pahintulot
KUMUHA /api/v1/operating-systems/{id}/

Kumuha ng isang Operating System

Bumalik ng isang operating system at ang mga aktibong bersyon nito, sa mga patlang sa itaas.

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

Mga Kodigo ng Katayuan ng Tugon

200 Tagumpay
404 Walang operating system na may na id

Pagpili ng isang bersyon

Tingnan ang mga bersyon up sa pamamagitan ng pangalan sa runtime sa halip ng hardcoding ng isang uuid, kaya ang iyong pagsasama ay patuloy na gumagana kapag ang mga bersyon ay idinagdag o nagretiro. Root login detalye ay email sa may-ari ng account sa sandaling ang server ay handa; magdagdag ng isang SSH key kapag paglikha ng server upang mag-log in sa isang key sa halip.