VPS.org API

REST API दस्तऐवजीकरण

प्लॅन API

तुम्ही वापरू शकणाऱ्या सर्वर योजनांची यादी, त्यांच्या संसाधन व किंमतीसह. तुम्ही सर्वर तयार किंवा आकार बदलविल्यावर योजना uuid ला plan_uuid म्हणून पास करा.

शेवटचे बिंदू 2
बेस पाथ /api/v1/plans
मिळवा /api/v1/plans/

सर्व योजनांची यादी करा

सर्व सक्रीय योजना परत करतो, सर्वात स्वस्त प्रथम. यादी अंतर्गत फिल्टर नाही व वर्तमानवेळी एका पानावर बसते.

आवश्यक परवानगी: plans:list

उदाहरण विनंती

cURL
Python
JavaScript
PHP
curl -X GET "https://admin.vps.org/api/v1/plans/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
import requests

url = "https://admin.vps.org/api/v1/plans/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for plan in response.json()["results"]:
    print(plan["uuid"], plan["cpu"], plan["ram"], plan["ram_unit"], plan["monthly_price"])
const response = await fetch('https://admin.vps.org/api/v1/plans/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
console.log(data.results);
$ch = curl_init('https://admin.vps.org/api/v1/plans/');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer YOUR_API_TOKEN']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$plans = json_decode(curl_exec($ch), true);
curl_close($ch);

उदाहरण प्रतिसाद

{
  "count": 12,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "ed0ac717-c26c-4d9b-a801-b170c4979028",
      "cpu": 1,
      "ram": 512,
      "ram_unit": "MB",
      "disk_space": 10,
      "disk_space_total": 10240,
      "transfer": 500,
      "transfer_unit": "GB",
      "includes_ipv4": false,
      "price": "2.50",
      "cpu_type_name": "Shared",
      "is_active": true,
      "hourly_price": "0.004",
      "monthly_price": "2.50",
      "is_gpu": false,
      "gpu_count": 0,
      "gpu_model": ""
    },
    {
      "uuid": "14186969-fbaf-43e1-9ab2-b1f1aeb66674",
      "cpu": 1,
      "ram": 2,
      "ram_unit": "GB",
      "disk_space": 25,
      "disk_space_total": 25600,
      "transfer": 1,
      "transfer_unit": "TB",
      "includes_ipv4": true,
      "price": "5.00",
      "cpu_type_name": "Shared",
      "is_active": true,
      "hourly_price": "0.007",
      "monthly_price": "5.00",
      "is_gpu": false,
      "gpu_count": 0,
      "gpu_model": ""
    }
  ]
}

प्रतिसाद फील्ड

क्षेत्र प्रकार वर्णन@ title: window
uuid string योजना ओळखकर्ता. याचा वापर plan_uuid किंवा new_plan_uuid म्हणून करा.
cpu integer vCPUs ची संख्या
ram, ram_unit integer, string स्मृती प्रमाण व त्याचे एकक (MB किंवा GB)
disk_space integer GB अंतर्गत डिस्क आकार
disk_space_total integer MB अंतर्गत डिस्क आकार
transfer, transfer_unit integer, string मासिक डेटा हस्तांतरण परवानगी आणि त्याचे एकक (GB किंवा TB)
disk_space_unit string डिस्क जागा (GB)
includes_ipv4 boolean योजना सार्वजनिक IPv4 पत्ता समाविष्ट करते का. एक नसलेले योजना फक्त IPv6 आहेत; $2.00/month साठी IPv4 पत्ता जोडला जाऊ शकतो.
monthly_price, price string अमेरिकन डॉलरमध्ये महिन्याचा दर दशलक्ष शब्दांप्रमाणे.
hourly_price string दशमांश स्ट्रिंग प्रमाणे USD मध्ये तासाची किंमत
cpu_type_name string CPU प्रकार, उदाहरणार्थ, सामायिक. CPU प्रकार न असलेली योजना, उदाहरणार्थ GPU योजना करीता टाकून द्या.
is_active boolean या यादीतील नेहमीच खरे, कारण निष्क्रीय योजना परत केले जात नाही
is_gpu, gpu_count, gpu_model boolean, integer, string योजना समर्पित GPU समाविष्ट करते का, किती, आणि कोणते मॉडेल
योजना IPv4 पत्ता समाविष्ट करते का हे उत्तर सांगत नाही. 512 MB योजना फक्त IPv6 आहे; इतर वर्तमान योजना IPv4 समाविष्ट करते. IPv4 वर पोहोचण्याकरीता साईटसाठी योजना निवडण्यापूर्वी किंमत पानाचे तुलना करा.

प्रतिसाद स्थिती कोड

200 यशस्वीरित्या प्राप्त केलेले योजना यादी
403 आढळले नाही किंवा अवैध API टोकन, किंवा टोकन करीता आवश्यक परवानगी आढळली नाही
मिळवा /api/v1/plans/{uuid}/

योजनेची माहिती मिळवा

वरील क्षेत्र सह एक सक्रीय योजना परत करतो. निष्क्रीय किंवा अपरिचीत uuid 404 परत करतो.

curl -X GET "https://admin.vps.org/api/v1/plans/ed0ac717-c26c-4d9b-a801-b170c4979028/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "uuid": "ed0ac717-c26c-4d9b-a801-b170c4979028",
  "cpu": 1,
  "ram": 512,
  "ram_unit": "MB",
  "disk_space": 10,
  "disk_space_total": 10240,
  "transfer": 500,
  "transfer_unit": "GB",
  "includes_ipv4": false,
  "price": "2.50",
  "cpu_type_name": "Shared",
  "is_active": true,
  "hourly_price": "0.004",
  "monthly_price": "2.50",
  "is_gpu": false,
  "gpu_count": 0,
  "gpu_model": ""
}