VPS.org API

وثائق REST API

واجهة برمجة تطبيقات الخطط

استرجع معلومات حول خطط الخوادم الافتراضية الخاصة المتاحة، والأسعار، ومواصفات الموارد.

نقاط النهاية 2 endpoints
المسار الأساسي /api/v1/plans
يحصل /api/v1/plans/

عرض جميع الخطط

استعادة قائمة بجميع خطط الخادم الافتراضي المتاحة مع التسعير ومواصفات الموارد.

معلمات الاستعلام

البارامترات يكتب مطلوب وصف المشروع
location string لا Filter plans by datacenter location

مثال على الطلب

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

url = "https://admin.vps.org/api/v1/plans/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch('https://admin.vps.org/api/v1/plans/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

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

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

مثال على الاستجابة

{
  "count": 4,
  "results": [
    {
      "id": 1,
      "name": "Starter VPS",
      "slug": "starter",
      "vcpus": 1,
      "memory": 2048,
      "storage": 40,
      "bandwidth": 1024,
      "price_monthly": 5.00,
      "price_hourly": 0.007,
      "available": true,
      "locations": ["us-west", "us-east", "eu-central"],
      "description": "Perfect for small projects and testing"
    },
    {
      "id": 2,
      "name": "Standard VPS",
      "slug": "standard",
      "vcpus": 2,
      "memory": 4096,
      "storage": 80,
      "bandwidth": 2048,
      "price_monthly": 10.00,
      "price_hourly": 0.015,
      "available": true,
      "locations": ["us-west", "us-east", "eu-central", "asia-pacific"],
      "description": "Ideal for web applications and small databases"
    },
    {
      "id": 3,
      "name": "Performance VPS",
      "slug": "performance",
      "vcpus": 4,
      "memory": 8192,
      "storage": 160,
      "bandwidth": 4096,
      "price_monthly": 20.00,
      "price_hourly": 0.030,
      "available": true,
      "locations": ["us-west", "us-east", "eu-central", "asia-pacific"],
      "description": "High-performance for demanding applications"
    },
    {
      "id": 4,
      "name": "Enterprise VPS",
      "slug": "enterprise",
      "vcpus": 8,
      "memory": 16384,
      "storage": 320,
      "bandwidth": 8192,
      "price_monthly": 40.00,
      "price_hourly": 0.060,
      "available": true,
      "locations": ["us-west", "us-east", "eu-central", "asia-pacific"],
      "description": "Enterprise-grade resources for mission-critical workloads"
    }
  ]
}

حقول الاستجابة

الميدان يكتب وصف المشروع
id integer معرّف الخطة الفريد
name string اسم الخطة سهل القراءة
slug string معرّف خطة متوافق مع عناوين URL
vcpus integer Number of virtual CPU cores
memory integer RAM in megabytes (MB)
storage integer Disk space in gigabytes (GB)
bandwidth integer Monthly data transfer in gigabytes (GB)
price_monthly decimal Monthly subscription price in USD
price_hourly decimal Hourly billing rate in USD
available boolean Whether plan is currently available for purchase
locations array List of datacenter locations where plan is available
description string Brief description of plan use case

رموز حالة الاستجابة

200 تم استرجاع قائمة الخطط بنجاح
401 غير مصرح به - رمز مصادقة غير صالح أو مفقود
يحصل /api/v1/plans/{plan_id}/

احصل على تفاصيل الخطة

استرجاع معلومات مفصلة عن خطة VPS محددة.

معلمات المسار

البارامترات يكتب مطلوب وصف المشروع
plan_id integer نعم معرف الخطة الفريد

مثال على الطلب

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

plan_id = 2
url = f"https://admin.vps.org/api/v1/plans/{plan_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())
const planId = 2;
const response = await fetch(`https://admin.vps.org/api/v1/plans/${planId}/`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const plan = await response.json();
console.log(plan);

مثال على الاستجابة

{
  "id": 2,
  "name": "Standard VPS",
  "slug": "standard",
  "vcpus": 2,
  "memory": 4096,
  "storage": 80,
  "bandwidth": 2048,
  "price_monthly": 10.00,
  "price_hourly": 0.015,
  "available": true,
  "locations": ["us-west", "us-east", "eu-central", "asia-pacific"],
  "description": "Ideal for web applications and small databases",
  "features": [
    "SSD Storage",
    "99.9% Uptime SLA",
    "Free Backups",
    "24/7 Support",
    "DDoS Protection",
    "IPv6 Support"
  ],
  "recommended_for": [
    "WordPress sites with moderate traffic",
    "Small to medium web applications",
    "Development and testing environments",
    "Personal projects and portfolios"
  ]
}

رموز حالة الاستجابة

200 Successfully retrieved plan details
401 غير مصرح به - رمز مصادقة غير صالح أو مفقود
404 غير موجود - الخطة غير موجودة

معلومات التسعير

خيارات الدفع

VPS.org يقدم خيارين للفواتير لتلبية احتياجاتك:

الفواتير الشهرية
  • سعر شهري ثابت بدون مفاجآت بدون مفاجآت
  • أفضل خيار لأعباء العمل الإنتاجية الطويلة الأجل
  • توفير تصل نسبته إلى 30 في المائة مقارنة بالحساب بالساعة
  • تدفع الفواتير في بداية كل شهر
  • لا توجد رسوم خفية أو رسوم إضافية
الفوترة بالساعة
  • لا تدفع إلا لساعات استخدامك
  • مثالي للاختبار والمشاريع القصيرة الأجل
  • تحسب الفواتير على أساس زيادة في الساعة
  • الحد الأقصى للرسوم المحددة بمعدل شهري
  • مثالية لبيئة التنمية

الميزات المضمنة

وتشمل جميع خطط VPS ما يلي:

  • ✓ تخزين SSD
  • ✓ 99.9 في المائة من مدة التشغيل
  • ✓ نسخ احتياطية يومية مجانية
  • ✓ دعم 24/7
  • ✓ حماية DDoS
  • ✓ دعم IPv6
  • ✓ الوصول الكامل إلى الجذر
  • ✓ صور سريعة
  • ✓ الشبكات الخاصة
  • ✓ الوصول إلى برمجيات التطبيقات

الموارد الإضافية

هل تحتاج إلى إضافة المزيد من الموارد؟ الخدمات الإضافية المتاحة:

اختيار الخطة الصحيحة

دليل سريع

الخطة الأفضل لـ حالات الاستخدام النموذجية
Starter VPS Personal projects, testing Static websites, learning environments, small blogs
Standard VPS Small businesses, web apps WordPress sites, small e-commerce, development servers
Performance VPS Medium traffic applications High-traffic WordPress, SaaS applications, databases
Enterprise VPS Large-scale applications Enterprise apps, large databases, video streaming
Need help choosing? تواصل مع فريق المبيعات لدينا على at sales@vps.org for personalized recommendations based on your specific requirements.