VPS.org API

REST API ကိုစာရွက်စာတမ်းများ

လည်ပတ်မှုစနစ်များ API

သင့်အနေဖြင့် တပ်ဆင်နိုင်သော operating systems များနှင့်၎င်းတို့၏ဗားရှင်းများကိုစာရင်းပြုစုပါ။ ဆာဗာတစ်ခုဖန်တီးသည့်အခါ operating_system_version_uuid အဖြစ် version ၏ uuid ကိုပေးပို့ပါ။

အဆုံးမှတ်များ 2
အခြေခံလမ်းကြောင်း /api/v1/operating-systems
ရယူပါ /api/v1/operating-systems/

လည်ပတ်မှုစနစ်များစာရင်း

လုပ်ဆောင်နေသော ဗားရှင်းများနှင့်အတူ operating system တစ်ခုချင်းစီကို ပြန်ပေးသည်။ စာရင်းတွင် စစ်ထုတ်ကိရိယာမရှိပါ။

ခွင့်ပြုချက်လိုအပ်သည်: 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 ဖြန့်ဝေမှုအမည်၊ ဥပမာ Ubuntu သို့မဟုတ် Debian
svg_icon string အမှတ်အသားရဲ့ SVG အမှတ်အသား (URL မဟုတ်)
versions array ထည့်သွင်းနိုင်သော သက်ဝင်သောဗားရှင်းများ
versions[].uuid string ဆာဗာတစ်ခုဖန်တီးရာတွင် operating_system_version_uuid အဖြစ်အသုံးပြု
versions[].name string version နှင့်ဗိသုကာ, ဥပမာအားဖြင့် 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string မိဘ လည်ပတ်မှုစနစ်၏ အမည်နှင့် ပုံသဏ္ဍာန်
versions[].is_active boolean ဆာဗာအသစ်များအတွက် အသုံးပြုနိုင်မလား

တုံ့ပြန်မှု အခြေအနေ ကုဒ်များ

200 အောင်မြင်စွာ ပြန်လည်ရယူထားသော လည်ပတ်မှုစနစ်များစာရင်း
403 API token မပါဘဲ သို့မဟုတ် မမှန်ကန်ပါ၊ သို့မဟုတ် token သည်လိုအပ်သောခွင့်ပြုချက်မရှိပါ
ရယူပါ /api/v1/operating-systems/{id}/

လည်ပတ်မှုစနစ်တစ်ခုရယူပါ

တစ်ခုတည်းသော operating system နှင့်၎င်း၏ သက်ဝင်သောဗားရှင်းကို အပေါ်က နယ်ပယ်များနှင့်အတူ ပြန်ပေးသည်။

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

တုံ့ပြန်မှု အခြေအနေ ကုဒ်များ

200 အောင်မြင်မှု
404 လည်ပတ်မှုစနစ်နှင့်အတူ ဤအိုင်ဒီမရှိပါ

ဗားရှင်းတစ်ခုရွေးခြင်း

ကြည့်ရှု version ကို runtime မှာ hardcoding အစားအမည်အားဖြင့်အ uuid မှာ version ကို, ဒါကြောင့်သင်၏ပေါင်းစည်းမှု version များထည့်သွင်းသို့မဟုတ်အငြိမ်းစားတဲ့အခါအလုပ်လုပ်ကိုင်ဆက်လက်. root login အချက်အလက်များတစ်ခါတစ်ရံ server ကိုအဆင်သင့်ဖြစ်ပါတယ်အကောင့်ပိုင်ရှင်ထံသို့အီးမေးလ်ပို့ကြသည်; အစား key ကိုနှင့်အတူ log in ဖို့ server ကိုဖန်တီးတဲ့အခါ SSH key ကို add.