VPS.org API

REST API Documentation

API Λειτουργικών Συστημάτων

Καταχωρήστε τα λειτουργικά συστήματα που μπορείτε να εγκαταστήσετε και τις εκδόσεις τους. Περάστε το uuid μιας έκδοσης ως λειτουργικό_system_version_uid όταν δημιουργείτε έναν διακομιστή.

Τελικά σημεία 2
Βασική διαδρομή /api/v1/operating-systems
ΠΑΙΡΝΩ /api/v1/operating-systems/

Κατάλογος λειτουργικών συστημάτων

Επιστρέφει κάθε λειτουργικό σύστημα με τις ενεργές εκδόσεις του.

Απαιτείται άδεια: operating-systems:list

Παράδειγμα Αιτήματος

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

Παράδειγμα απάντησης

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

Μικρότερη: εμφανίζεται μόνο ένα λειτουργικό σύστημα και η σήμανση SVG κόβεται.

Πεδία απόκρισης

Πεδίο Τύπος Description
id integer Κωδικός αναγνώρισης λειτουργικού συστήματος
name string Όνομα διανομής, για παράδειγμα Ubuntu ή Debian
svg_icon string Inline SVG markup του λογότυπου (όχι URL)
versions array Ενεργές εκδόσεις μπορείτε να εγκαταστήσετε
versions[].uuid string Χρήση ως λειτουργικό_system_version_uid κατά τη δημιουργία ενός εξυπηρετητή
versions[].name string Έκδοση και αρχιτεκτονική, για παράδειγμα 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Όνομα και εικονίδιο του μητρικού λειτουργικού συστήματος
versions[].is_active boolean Αν η έκδοση μπορεί να χρησιμοποιηθεί για νέους διακομιστές

Κωδικοί κατάστασης απόκρισης

200 Κατάλογος λειτουργικών συστημάτων που ανακτήθηκαν επιτυχώς
403 Λείπει ή άκυρο API, ή το σύμβολο στερείται της απαιτούμενης άδειας
ΠΑΙΡΝΩ /api/v1/operating-systems/{id}/

Πάρτε ένα λειτουργικό σύστημα

Επιστρέφει ένα λειτουργικό σύστημα και τις ενεργές εκδόσεις του, με τα παραπάνω πεδία.

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

Κωδικοί κατάστασης απόκρισης

200 Επιτυχία
404 Δεν υπάρχει λειτουργικό σύστημα με αυτό το ID

Επιλέγοντας μια Έκδοση

Αναζήτηση εκδόσεων με το όνομα στο runtime αντί για hardcoding ένα uuid, έτσι ώστε η ολοκλήρωση σας συνεχίζει να λειτουργεί όταν οι εκδόσεις προστίθενται ή αποσύρονται. Λεπτομέρειες σύνδεσης ρίζας αποστέλλονται με email στον ιδιοκτήτη του λογαριασμού μόλις ο εξυπηρετητής είναι έτοιμος; προσθέστε ένα κλειδί SSH κατά τη δημιουργία του διακομιστή για να συνδεθείτε με ένα κλειδί αντί.