VPS.org API

Tahirin-kevitra REST API

API momba ny Rafitra Fampiasana

Mamaritra ireo rafitra miasa azonao apetraka sy ny kinovany. Alefaso amin'ny operating_system_version_uuid ny uuid'ny kinova rehefa mamorona mpizara ianao.

Teboka farany 2
Lalana fototra /api/v1/operating-systems
ALAO /api/v1/operating-systems/

Lisitry ny rafi-piasana

Maneho ny rafitra fiasa tsirairay miaraka amin'ny kinova miasa. Tsy misy sivana ilay lisitra.

Mila alalana: operating-systems:list

Ohatra amin'ny fangatahana

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

Ohatra amin'ny Valiny

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

Voafafa: rafitra iray ihany no aseho ary voafafa ny mari-tsoratra SVG.

Saha Valiny

Field Karazana Fanoritsoritana
id integer Mpamantatra ny rafi-piasana
name string Anaran'ny fizarana, ohatra Ubuntu na Debian
svg_icon string Marika SVG anatin'ny andalana ho an'ilay famantarana (tsy URL)
versions array Kinova miasa azonao apetraka
versions[].uuid string Ampiasaina ho toy ny operating_system_version_uuid rehefa mamorona mpizara iray
versions[].name string Kinova sy rafitra, ohatra 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Anaran'ny rafitra fiasa reny sy kisary
versions[].is_active boolean Raha azo ampiasaina amin'ny mpizara vaovao ilay kinova

Kaody momba ny satan'ny valiny

200 Lisitr'ireo rafi-piasana azo tsara
403 Token API tsy misy na tsy mitombina, na tsy manana ny fahazoan-dàlana ilaina ilay token
ALAO /api/v1/operating-systems/{id}/

Handray rafitra fiasa iray

Maneho ny rafitra fiasa iray sy ny kinova miasa amin'io, miaraka amin'ireo sehatr'asa eo ambony.

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

Kaody momba ny satan'ny valiny

200 Fahombiazana
404 Tsy misy rafitra miasa manana io ID io

Misafidiana kinova iray

Mitady ny kinova araka ny anarany mandritra ny fotoana fandefasana fa tsy amin'ny alalan'ny famaritana uuid, mba tsy hitsahatra ny fidirana rehefa misy kinova vaovao na efa tsy misy intsony. Alefa amin'ny mailaka any amin'ny tompon'ny kaonty ny antsipirian'ny fidirana amin'ny maha-faharoa rehefa vita ny mpizara; ampidiro famaha SSH rehefa mamorona ny mpizara mba hidirana amin'ny alalan'ny famaha fa tsy amin'ny alalan'ny uuid.