VPS.org API

REST API belgelendirmesi

İşletim Sistemleri API'si

Kurulabileceğiniz işletim sistemlerini ve sürümlerini listele. Bir sunucu oluşturduğunuzda bir sürümün uuid'ini operating_system_version_uuid olarak gönderin.

Uç noktalar 2
Temel Yol /api/v1/operating-systems
ELDE ETMEK /api/v1/operating-systems/

İşletim Sistemlerini Listele

Her işletim sistemini aktif sürümleriyle birlikte geri getirir. Listede filtre yoktur.

İzin gerekiyor: operating-systems:list

Örnek Talep

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

Örnek Yanıt

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

Kısalaştırılmış: sadece bir işletim sistemi gösterilir ve SVG işareti kesilir.

Yanıt Alanları

Alan Tip Açıklama
id integer İşletim sistemi tanımlayıcısı
name string Dağıtım adı, örneğin Ubuntu veya Debian
svg_icon string Logonun içindeki SVG işaretleme (URL değil)
versions array Kurulabileceğiniz aktif sürümler
versions[].uuid string Sunucu oluştururken işletim sistemi_sürümü_uuid olarak kullanılsın
versions[].name string Sürüm ve mimari, örneğin 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Ana işletim sisteminin adı ve simgesi
versions[].is_active boolean Sürümün yeni sunucularda kullanılıp kullanılmayacağı

Yanıt Durum Kodları

200 Başarıyla alınan işletim sistemleri listesi
403 Eksik veya geçersiz API token'ı, ya da token'ın gerekli izinleri yok
ELDE ETMEK /api/v1/operating-systems/{id}/

İşletim Sistemi Al

Üstteki alanlarla bir işletim sistemi ve aktif sürümlerini geri verir.

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

Yanıt Durum Kodları

200 Başarı
404 Bu id ile işletim sistemi yok

Bir sürüm seçmek

Bir uuid'i sert kodlamak yerine sürümleri isimle çalıştırma sırasında ara, böylece entegrasyonunuz sürümler eklendiğinde veya emekli edildiğinde de çalışacak. Sunucu hazır olduğunda root giriş bilgileri hesap sahibine e-posta ile gönderilir; yerine bir anahtar ile giriş yapmak için sunucu oluştururken bir SSH anahtarı ekleyin.