VPS.org API

REST 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 लोगोको इनलाइन एसभीजी मार्कअप (यूआरएल होइन)
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 त्यो आईडीसँग सञ्चालन प्रणाली छैन

संस्करण चयन गर्दै

uuid लाई हार्डकोडिङ गर्नुको सट्टा रनटाइममा नामद्वारा संस्करणहरू माथि हेर्नुहोस्, त्यसैले संस्करणहरू थपिएको वा सेवानिवृत्त भएको बेलामा तपाईँको एकीकरणले काम गरिरहेको राख्दछ । सर्भर तयार भएपछि मूल लगइन विवरणहरू खाता मालिकलाई इमेल गरिन्छ; सर्भर सिर्जना गर्दा SSH कुञ्जी थप्नुहोस् सट्टामा कुञ्जीसँग लगइन गर्न ।