VPS.org API

REST API دستاویزی

آپریٹنگ سسٹم API

آپ کو ان آپریٹنگ سسٹم اور ان کے ورژنوں کی فهرست فراہم کرائی جائے گی. آپ سرور بناتے وقت ورژن کے uuid کو آپریٹنگ سسٹم ورژن uuid کے طور پر منتقل کریں.

اینڈ پوائنٹس 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 مارک اپ کاٹ دیا جاتا هے

رسپانس فیلڈز

شعبہ قسم وضاحت
id integer آپریٹنگ سسٹم شناخت
name string تقسیم نام، مثال کے طور پر اوبنٹو یا ڈیبیان
svg_icon string لوگو کا انلاین SVG مارک اپ (URL نہیں)
versions array فعال ورژن جو آپ انسٹال کرسکتے ہیں
versions[].uuid string سرور بنانے کے وقت آپریٹنگ سسٹم ورژن uuid کے طور پر استعمال کریں
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 کے ساتھ کوئی آپریٹنگ سسٹم نہیں

نسخہ منتخب کر رہے ہیں

رن ٹائم میں نام کے مطابق ورژن دیکھیں uuid کو ہارڈ کوڈ کرنے کی بجائے، تاکہ آپ کا انٹیگریشن کام کرتا رہے جب ورژن شامل ہوں یا معطل ہوں سرور تیار ہو جانے کے بعد روٹ لاگ ان کی تفصیلات اکاؤنٹ مالک کو ای میل کی جاتی ہیں۔ اس کی جگہ ایک کلید کے ساتھ لاگ ان کرنے کے لیے سرور بنانے کے وقت SSH کی کلید شامل کریں.