VPS.org API

Documentazione API REST

API dei piani

Recupera informazioni sui piani VPS disponibili, sui prezzi e sulle specifiche delle risorse.

Punti finali 2 endpoints
Percorso di base /api/v1/plans
OTTENERE /api/v1/plans/

Elenca tutti i piani

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

Parametri di query

Parametro Tipo Necessario Descrizione
location string NO Filter plans by datacenter location

Richiesta di esempio

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);

Esempio di risposta

{
  "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"
    }
  ]
}

Campi di risposta

Field Tipo Descrizione
id integer Identificatore univoco del piano
name string Nome del piano leggibile dall'uomo
slug string Identificatore del piano compatibile con 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

Codici di stato della risposta

200 Elenco dei piani recuperato con successo
401 Non autorizzato - Token di autenticazione non valido o mancante
OTTENERE /api/v1/plans/{plan_id}/

Ottieni i dettagli del piano

Retrieve detailed information about a specific VPS plan.

Parametri del percorso

Parametro Tipo Necessario Descrizione
plan_id integer ID piano univoco

Richiesta di esempio

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);

Esempio di risposta

{
  "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"
  ]
}

Codici di stato della risposta

200 Successfully retrieved plan details
401 Non autorizzato - Token di autenticazione non valido o mancante
404 Non trovato - Il piano non esiste

Pricing Information

Opzioni di fatturazione

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

Monthly Billing
  • Tariffa mensile fissa senza sorprese 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 Ideale per Casi d'uso tipici
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? Contatta il nostro team di vendita a at sales@vps.org for personalized recommendations based on your specific requirements.