VPS.org API

مستندات REST API

API پلن‌ها

اطلاعات مربوط به پلن‌های VPS موجود، قیمت‌گذاری و مشخصات منابع را بازیابی کنید.

نقاط پایانی 2 endpoints
مسیر پایه /api/v1/plans
دریافت کنید /api/v1/plans/

لیست همه طرح‌ها

Retrieve a list of all available VPS plans with pricing and resource specifications.

پارامترهای پرس و جو

پارامتر نوع مورد نیاز توضیحات
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"
    }
  ]
}

فیلدهای پاسخ

Field نوع توضیحات
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}/

جزئیات طرح را دریافت کنید

Retrieve detailed information about a specific VPS plan.

پارامترهای مسیر

پارامتر نوع مورد نیاز توضیحات
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 یافت نشد - طرح وجود ندارد

Pricing Information

گزینه‌های صورتحساب

VPS.org offers two billing options to suit your needs:

Monthly Billing
  • نرخ ثابت ماهانه بدون هیچ گونه غافلگیری with no surprises
  • Best for long-term, production workloads
  • Save up to 30% compared to hourly billing
  • Billed at the start of each month
  • No hidden fees or overage charges
Hourly Billing
  • Pay only for the hours you use
  • Perfect for testing and short-term projects
  • Billed in hourly increments
  • Maximum charge capped at monthly rate
  • Ideal for development environments

Included Features

All VPS plans include:

  • ✓ SSD Storage
  • ✓ 99.9% Uptime SLA
  • ✓ Free Daily Backups
  • ✓ 24/7 Customer Support
  • ✓ DDoS Protection
  • ✓ IPv6 Support
  • ✓ Full Root Access
  • ✓ Snapshots
  • ✓ Private Networking
  • ✓ API Access

Additional Resources

Need to add more resources? Additional services available:

Choosing the Right Plan

Quick Guide

Plan بهترین برای موارد استفاده معمول
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.