VPS.org API

REST API ලේඛන

මෙහෙයුම් පද්ධති API

ඔබට ස්ථාපනය කල හැකි මෙහෙයුම් පද්ධති සහ ඒවායේ සංස්කරණ ලැයිස්තුගත කරන්න. ඔබ සේවාදායකයක් නිර්මාණය කරන විට operating_system_version_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 බෙදාහැරීමේ නාමය, උදාහරණයක් ලෙස Ubuntu හෝ Debian
svg_icon string ලාංඡනයේ අන්තර්ගත SVG ලකුණු (URL එකක් නොවේ)
versions array ඔබට ස්ථාපනය කළ හැකි සක්‍රීය සංස්කරණ
versions[].uuid string ධාරකයක් නිර්මාණය කරන විට මෙහෙයුම් පද්ධති අනුවාදය ලෙස භාවිත කරන්න
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 hardcoding වෙනුවට runtime දී නාමය විසින් අනුවාදයන් දක්වා බලන්න, එබැවින් අනුවාදයන් එකතු හෝ විශ්රාම විට ඔබේ ඒකාබද්ධතාව වැඩ පවතී. සේවාදායකය සූදානම් වූ පසු මුල් පිවිසුම් විස්තර ගිණුම් හිමිකරු වෙත ඊ-තැපැල්; වෙනුවට යතුරක් සමඟ පිවිසීමට සේවාදායකය නිර්මාණය කරන විට SSH යතුරක් එකතු.