VPS.org API

REST API ਡੌਕੂਮੈਂਟੇਸ਼ਨ

ਓਪਰੇਟਿੰਗ ਸਿਸਟਮ API

ਓਪਰੇਟਿੰਗ ਸਿਸਟਮ ਦੀ ਲਿਸਟ ਜੋ ਤੁਸੀਂ ਇੰਸਟਾਲ ਕਰ ਸਕਦੇ ਹੋ ਅਤੇ ਉਨ੍ਹਾਂ ਦੇ ਵਰਜਨ। ਜਦੋਂ ਤੁਸੀਂ ਸਰਵਰ ਬਣਾਓ ਤਾਂ ਵਰਜਨ ਦਾ uuid operating_system_version_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 Version and architecture, for example 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 ਕੁੰਜੀ ਸ਼ਾਮਲ ਕਰੋ ਤਾਂ ਕਿ ਇਸ ਦੀ ਬਜਾਏ ਕੁੰਜੀ ਨਾਲ ਲਾਗਇਨ ਕੀਤਾ ਜਾ ਸਕੇ ।