VPS.org API

Tài liệu API REST

API hệ điều hành

Danh sách các hệ điều hành có thể cài đặt và phiên bản của chúng. Chuyển uuid của phiên bản thành operating_system_version_uuid khi tạo máy chủ.

Điểm cuối 2
Đường cơ sở /api/v1/operating-systems
LẤY /api/v1/operating-systems/

Danh sách hệ điều hành

Trả lại mỗi hệ điều hành với phiên bản đang hoạt động. Danh sách không có bộ lọc.

Cần quyền: operating-systems:list

Ví dụ về yêu cầu

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

Ví dụ về câu trả lời

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

rút ngắn: chỉ có một hệ điều hành được hiển thị và đánh dấu SVG được cắt.

Các trường phản hồi

Địa điểm Kiểu Mô tả
id integer Tên hệ điều hành
name string Tên của bản phân phối, ví dụ Ubuntu hay Debian
svg_icon string Biểu tượng SVG trong dòng của biểu tượng (không phải URL)
versions array Phiên bản hoạt động có thể cài đặt
versions[].uuid string Dùng như hệ điều hành_ phiên bản_ uuid khi tạo máy phục vụ
versions[].name string Phiên bản và kiến trúc, ví dụ 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Tên và biểu tượng của hệ điều hành mẹ
versions[].is_active boolean Có thể dùng phiên bản này cho máy chủ mới không

Mã trạng thái phản hồi

200 Danh sách hệ điều hành đã lấy lại thành công
403 Thiếu hoặc không hợp lệ token API, hoặc token không có quyền cần thiết
LẤY /api/v1/operating-systems/{id}/

Nhập hệ điều hành

Trả lại một hệ điều hành và phiên bản đang hoạt động, với các trường ở trên.

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

Mã trạng thái phản hồi

200 Thành công
404 Không có hệ điều hành nào có ID đó

Chọn phiên bản

Tìm phiên bản theo tên trong thời gian chạy thay vì mã hóa uuid, vì vậy việc tích hợp vẫn hoạt động khi phiên bản được thêm hoặc rút lui. Chi tiết đăng nhập root sẽ được gửi qua thư điện tử cho chủ tài khoản khi máy phục vụ sẵn sàng; thêm một khóa SSH khi tạo máy phục vụ để đăng nhập bằng khóa thay thế.