VPS.org API

Dokumentado de REST API

API de Operaciumoj

Akiri informojn pri disponeblaj operaciumoj kaj distribuaĵoj por viaj VPS-serviloj.

Finpunktoj 2 endpoints
Baza Pado /api/v1/operating-systems
AKIRU /api/v1/operating-systems/

Listigi Ĉiujn Operaciumojn

Elpreni liston de ĉiuj disponeblaj operaciumoj, kiuj povas esti instalitaj en VPS- serviloj.

Demandparametroj

Parametroj Tipo Bezonata Priskribo
os_type string No Filter by OS type: linux, windows
featured boolean No Show only featured operating systems

Ekzempla Peto

cURL
Python
JavaScript
PHP
curl -X GET "https://admin.vps.org/api/v1/operating-systems/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

url = "https://admin.vps.org/api/v1/operating-systems/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch('https://admin.vps.org/api/v1/operating-systems/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const os = await response.json();
console.log(os);
$ch = curl_init('https://admin.vps.org/api/v1/operating-systems/');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$operating_systems = json_decode($response, true);
curl_close($ch);

Ekzempla Respondo

{
  "count": 12,
  "results": [
    {
      "id": 1,
      "name": "Ubuntu 22.04 LTS",
      "slug": "ubuntu-22-04",
      "version": "22.04",
      "os_type": "linux",
      "distribution": "Ubuntu",
      "architecture": "x86_64",
      "featured": true,
      "available": true,
      "min_disk_gb": 10,
      "description": "Ubuntu 22.04 LTS (Jammy Jellyfish) - Long Term Support until 2027",
      "icon_url": "https://cdn.vps.org/os-icons/ubuntu.svg"
    },
    {
      "id": 2,
      "name": "Debian 12",
      "slug": "debian-12",
      "version": "12",
      "os_type": "linux",
      "distribution": "Debian",
      "architecture": "x86_64",
      "featured": true,
      "available": true,
      "min_disk_gb": 10,
      "description": "Debian 12 (Bookworm) - Stable release",
      "icon_url": "https://cdn.vps.org/os-icons/debian.svg"
    },
    {
      "id": 3,
      "name": "CentOS Stream 9",
      "slug": "centos-stream-9",
      "version": "9",
      "os_type": "linux",
      "distribution": "CentOS",
      "architecture": "x86_64",
      "featured": false,
      "available": true,
      "min_disk_gb": 10,
      "description": "CentOS Stream 9 - Rolling release tracking RHEL development",
      "icon_url": "https://cdn.vps.org/os-icons/centos.svg"
    },
    {
      "id": 4,
      "name": "Fedora 39",
      "slug": "fedora-39",
      "version": "39",
      "os_type": "linux",
      "distribution": "Fedora",
      "architecture": "x86_64",
      "featured": false,
      "available": true,
      "min_disk_gb": 15,
      "description": "Fedora 39 - Cutting-edge Linux distribution",
      "icon_url": "https://cdn.vps.org/os-icons/fedora.svg"
    },
    {
      "id": 5,
      "name": "Rocky Linux 9",
      "slug": "rocky-linux-9",
      "version": "9",
      "os_type": "linux",
      "distribution": "Rocky Linux",
      "architecture": "x86_64",
      "featured": true,
      "available": true,
      "min_disk_gb": 10,
      "description": "Rocky Linux 9 - Enterprise-grade Linux, RHEL compatible",
      "icon_url": "https://cdn.vps.org/os-icons/rocky.svg"
    }
  ]
}

Respondaj Kampoj

Kampo Tipo Priskribo
id integer Unique operating system identifier
name string Full operating system name with version
slug string URL-friendly OS identifier
version string OS version number
os_type string Operating system type: linux or windows
distribution string Distribution name (Ubuntu, Debian, CentOS, etc.)
architecture string CPU architecture (x86_64, arm64, etc.)
featured boolean Whether OS is featured/recommended
available boolean Whether OS is currently available for installation
min_disk_gb integer Minimum disk space required in gigabytes
description string Brief description of the operating system
icon_url string URL to OS icon/logo image

Respondaj Statusaj Kodoj

200 Sukcese prenita listo de operaciumoj
401 Neaŭtorizita - Malvalida aŭ mankanta aŭtentiga ĵetono
AKIRU /api/v1/operating-systems/{os_id}/

Preni detalojn pri la operaciumo

Elpreni detalan informon pri specifa operaciumo.

Padaj Parametroj

Parametroj Tipo Bezonata Priskribo
os_id integer Jes Unique operating system ID

Ekzempla Peto

cURL
Python
JavaScript
curl -X GET "https://admin.vps.org/api/v1/operating-systems/1/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

os_id = 1
url = f"https://admin.vps.org/api/v1/operating-systems/{os_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())
const osId = 1;
const response = await fetch(`https://admin.vps.org/api/v1/operating-systems/${osId}/`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const os = await response.json();
console.log(os);

Ekzempla Respondo

{
  "id": 1,
  "name": "Ubuntu 22.04 LTS",
  "slug": "ubuntu-22-04",
  "version": "22.04",
  "os_type": "linux",
  "distribution": "Ubuntu",
  "architecture": "x86_64",
  "featured": true,
  "available": true,
  "min_disk_gb": 10,
  "description": "Ubuntu 22.04 LTS (Jammy Jellyfish) - Long Term Support until 2027",
  "icon_url": "https://cdn.vps.org/os-icons/ubuntu.svg",
  "release_date": "2022-04-21",
  "support_end_date": "2027-04-21",
  "default_user": "root",
  "package_manager": "apt",
  "init_system": "systemd",
  "kernel_version": "5.15",
  "features": [
    "Long Term Support (LTS) until 2027",
    "5 years of free security updates",
    "Extended Security Maintenance available",
    "Large community support",
    "Extensive package repository",
    "Cloud-optimized kernel",
    "Regular point releases"
  ],
  "recommended_for": [
    "Web servers (Apache, Nginx)",
    "Application servers",
    "Database servers (MySQL, PostgreSQL)",
    "Docker containers",
    "Kubernetes nodes",
    "Development environments",
    "Production workloads"
  ],
  "installation_notes": [
    "Requires minimum 10GB disk space",
    "SSH enabled by default on port 22",
    "UFW firewall available but not enabled by default",
    "Automatic security updates can be configured",
    "Cloud-init supported for automated setup"
  ]
}

Respondaj Statusaj Kodoj

200 Successfully retrieved operating system details
401 Neaŭtorizita - Malvalida aŭ mankanta aŭtentiga ĵetono
404 Not Found - Operating system does not exist

Featured Operating Systems

VPS.org rekomendas la sekvajn operaciumojn por plej multaj uzoj:

Ubuntu 22.04 LTS
  • Best for: General purpose servers, web hosting
  • Support: Until April 2027
  • Package Manager: APT
  • Why choose: Most popular, extensive documentation, large community
Debian 12
  • Best for: Stability-focused production servers
  • Support: ~5 years
  • Package Manager: APT
  • Why choose: Rock-solid stability, security-focused
Rocky Linux 9
  • Best for: Enterprise applications, RHEL workloads
  • Support: ~10 years
  • Package Manager: DNF/YUM
  • Why choose: RHEL compatible, enterprise-grade
AlmaLinux 9
  • Best for: Enterprise servers, cPanel hosting
  • Support: ~10 years
  • Package Manager: DNF/YUM
  • Why choose: RHEL compatible, backed by CloudLinux

Elekti la ĝustan operaciumon

Laŭ uzokazo

Uzkazo Rekomendita operaciumo Kialo
Web Hosting Ubuntu 22.04 LTS, Debian 12 Excellent LAMP/LEMP stack support, large community
Docker/Containers Ubuntu 22.04 LTS, Debian 12 Native Docker support, optimized kernels
Enterprise Apps Rocky Linux 9, AlmaLinux 9 RHEL compatibility, long support cycles
Development Ubuntu 22.04 LTS, Fedora 39 Latest packages, developer-friendly tools
Database Servers Debian 12, Rocky Linux 9 Stability, performance, long-term support
cPanel Hosting AlmaLinux 9, Rocky Linux 9 Official cPanel support

Laŭ spertnivelo

Ĉu vi bezonas helpon por elekti? Kontaktu nian subtenteamon ĉe hello@vps.org por personaj OS- rekomendoj bazitaj sur viaj specifaj postuloj.

Instalado kaj agordo

Kio okazas dum OS-instalado

  1. Bildelekto: OS- ŝablono estas elektita el nia deponejo
  2. Diska subdivido: Aŭtomata subdivido bazita sur plangrandeco
  3. Baza instalo: Kernaj OS-pakaĵoj estas instalitaj (5-10 minutoj)
  4. Retagordo: IP- adreso, DNS, kaj kluzo agorditajName
  5. SSH- agordo: SSH-servilo ebligita sur pordo 22
  6. Sistemestro- aliro: Pasvorto de sistemestro sendita per retpoŝto
  7. Nuba starto: Aplikata komenca agordo (se subtenata)

Postinstalaj paŝoj

Apriora identigilo

Grava: La radikaj identigiloj estas senditaj al via registrita retpoŝtadreso tuj post la kreo de la servilo. Ŝanĝu la defaŭltan pasvorton dum la unua ensaluto pro sekureco.

Subteno kaj dokumentado

Por specifaj OS-specifaj agordaj gvidlinioj, vizitu nian Dokumenta centro: