VPS.org API

Documentazione REST API

API di i lochi

Retrieve information about available datacenter locations for VPS deployment.

Punti finali 1 endpoint
Percorsu di Base /api/v1/locations
OTTIENI /api/v1/locations/

Elencu di tutti i lochi

Ricuperà una lista di tutti i lochi di datacenter dispunibili induve pudete dispiegà i servitori VPS.

Parametri di dumanda

Parametri Tipu Obbligatoriu Descrizzioni
region string No Filter by region: north-america, europe, asia, oceania
available boolean No Show only locations currently accepting new servers

Esempiu di dumanda

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

url = "https://admin.vps.org/api/v1/locations/"
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/locations/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

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

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

Esempiu di risposta

{
  "count": 8,
  "results": [
    {
      "id": 1,
      "name": "New York",
      "slug": "ny-usa",
      "country": "United States",
      "country_code": "US",
      "city": "New York",
      "region": "north-america",
      "continent": "North America",
      "available": true,
      "latitude": 40.7128,
      "longitude": -74.0060,
      "network_provider": "Digital Realty",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Low Latency to US East Coast"
      ],
      "average_latency_ms": {
        "us-east": 2,
        "us-west": 75,
        "europe": 85,
        "asia": 220
      }
    },
    {
      "id": 2,
      "name": "San Francisco",
      "slug": "sf-usa",
      "country": "United States",
      "country_code": "US",
      "city": "San Francisco",
      "region": "north-america",
      "continent": "North America",
      "available": true,
      "latitude": 37.7749,
      "longitude": -122.4194,
      "network_provider": "Equinix",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Low Latency to US West Coast & Asia"
      ],
      "average_latency_ms": {
        "us-east": 75,
        "us-west": 2,
        "europe": 150,
        "asia": 120
      }
    },
    {
      "id": 3,
      "name": "London",
      "slug": "lon-uk",
      "country": "United Kingdom",
      "country_code": "GB",
      "city": "London",
      "region": "europe",
      "continent": "Europe",
      "available": true,
      "latitude": 51.5074,
      "longitude": -0.1278,
      "network_provider": "Telehouse",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "GDPR Compliant",
        "Low Latency to Europe"
      ],
      "average_latency_ms": {
        "us-east": 85,
        "us-west": 150,
        "europe": 5,
        "asia": 180
      }
    },
    {
      "id": 4,
      "name": "Frankfurt",
      "slug": "fra-de",
      "country": "Germany",
      "country_code": "DE",
      "city": "Frankfurt",
      "region": "europe",
      "continent": "Europe",
      "available": true,
      "latitude": 50.1109,
      "longitude": 8.6821,
      "network_provider": "Interxion",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "GDPR Compliant",
        "Central European Location"
      ],
      "average_latency_ms": {
        "us-east": 95,
        "us-west": 160,
        "europe": 3,
        "asia": 200
      }
    },
    {
      "id": 5,
      "name": "Singapore",
      "slug": "sgp-sg",
      "country": "Singapore",
      "country_code": "SG",
      "city": "Singapore",
      "region": "asia",
      "continent": "Asia",
      "available": true,
      "latitude": 1.3521,
      "longitude": 103.8198,
      "network_provider": "Equinix",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Low Latency to Asia Pacific"
      ],
      "average_latency_ms": {
        "us-east": 250,
        "us-west": 180,
        "europe": 170,
        "asia": 5
      }
    },
    {
      "id": 6,
      "name": "Tokyo",
      "slug": "tok-jp",
      "country": "Japan",
      "country_code": "JP",
      "city": "Tokyo",
      "region": "asia",
      "continent": "Asia",
      "available": true,
      "latitude": 35.6762,
      "longitude": 139.6503,
      "network_provider": "Equinix",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Low Latency to East Asia"
      ],
      "average_latency_ms": {
        "us-east": 180,
        "us-west": 120,
        "europe": 240,
        "asia": 8
      }
    },
    {
      "id": 7,
      "name": "Sydney",
      "slug": "syd-au",
      "country": "Australia",
      "country_code": "AU",
      "city": "Sydney",
      "region": "oceania",
      "continent": "Oceania",
      "available": true,
      "latitude": -33.8688,
      "longitude": 151.2093,
      "network_provider": "NextDC",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Low Latency to Australia & New Zealand"
      ],
      "average_latency_ms": {
        "us-east": 210,
        "us-west": 140,
        "europe": 280,
        "asia": 120
      }
    },
    {
      "id": 8,
      "name": "Toronto",
      "slug": "tor-ca",
      "country": "Canada",
      "country_code": "CA",
      "city": "Toronto",
      "region": "north-america",
      "continent": "North America",
      "available": true,
      "latitude": 43.6532,
      "longitude": -79.3832,
      "network_provider": "Cologix",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Data Sovereignty (Canada)"
      ],
      "average_latency_ms": {
        "us-east": 20,
        "us-west": 65,
        "europe": 90,
        "asia": 210
      }
    }
  ]
}

Campi di risposta

Campu Tipu Descrizzioni
id integer Unique location identifier
name string Human-readable location name
slug string URL-friendly location identifier
country string Country name
country_code string ISO 3166-1 alpha-2 country code
city string City name
region string Geographic region (north-america, europe, asia, oceania)
continent string Continent name
available boolean Whether location is accepting new servers
latitude decimal Geographic latitude
longitude decimal Geographic longitude
network_provider string Datacenter/network provider name
features array List of location-specific features
average_latency_ms object Average latency in milliseconds to major regions

Codici di Statu di Risposta

200 Lista di lochi recuperata cù successu
401 Micca autorizatu - Token d'autentificazione invalidu o mancante

Choosing the Right Location

Pû publicu di destinazione

Target Audience Recommended Locations Why
US East Coast Users New York, Toronto Lowest latency (2-20ms), close proximity
US West Coast Users San Francisco Lowest latency (2ms), silicon valley connectivity
European Users London, Frankfurt GDPR compliant, low latency (3-5ms) across Europe
Asian Users Singapore, Tokyo Best connectivity to Asia Pacific region (5-8ms)
Australian/NZ Users Sydney Only Oceania location, lowest latency to Australia
Global Audience Multiple locations with load balancing Deploy in 2-3 regions for global coverage

Per Requisiti di Conformità

Prestazioni di a rete

Latenza cchiù vascia versu i mercati principali
  • America dû Nord New York (2ms versu l'est di l'USA), San Francisco (2ms versu l'ovest di l'USA)
  • Europa: Frankfurt (3ms), Londra (5ms)
  • Asia: Singapore (5ms), Tokyo (8ms)
  • Oceania Sydney (solu opzioni)
Migliore per a distribuzione globale
  1. Primariu: New York o San Francisco (più granni basi d'utenti)
  2. Sicunnu: Londra o Francuforti (copertura di l'Europa)
  3. Terziariu: Singapore o Tokyo (copertura asiatica)
Suggerimentu: Per l'applicazioni mission-critical, dispiegà à più posti cù failover automaticu per u massimu uptime è ridondanza giugrafica.

Infrastruttura di Datacenter

Caratteristichi standard (tutti i loca)

  • ✓ Tier III o datacenters cchiù alti
  • ✓ 100% uptime SLA
  • ✓ Potenza ridondanti (N+1 o 2N)
  • ✓ Raffreddamentu ridondanti
  • ✓ Sicurezza fisica 24/7
  • ✓ Controlli di accessu biometricu
  • ✓ Protezione DDoS (finu à 10 Tbps mitigazione)
  • ✓ Supportu IPv4 e IPv6
  • ✓ Rete privata (VLAN)
  • ✓ 10 Gbps + backbone di rete
  • ✓ Fornituri ascendenti multipli
  • ✓ Peering BGP cu reti principali

Furnituri di rete

Località Furnituri Livellu Note
New York Digital Realty Tier III Major internet exchange point
San Francisco Equinix Tier III Silicon Valley connectivity hub
London Telehouse Tier III LINX (London Internet Exchange)
Frankfurt Interxion Tier III DE-CIX (world's largest IXP)
Singapore Equinix Tier III Asia Pacific connectivity hub
Tokyo Equinix Tier III JPIX and JPNAP peering
Sydney NextDC Tier III Oceania's largest datacenter
Toronto Cologix Tier III Canadian data sovereignty

Location Migration & Multi-Region Deployment

Muvimentu tra i loca

Puoi migrà u vostru VPS in una posizione diversa usando istantanee:

  1. Cria n'istantanea dû vostru VPS esistenti
  2. Crea un novu VPS ntâ pusizzioni di destinazzioni
  3. Ripristina l'istantanea in u novu VPS
  4. Aggiorna i registri DNS pi puntari a nu novu IP
  5. Elimina u vechju VPS una volta verificata a migrazione
Note: A migrazione versu una nova pusizioni darà un novu indirizzu IP. Pianificate u tempu di propagazione DNS (tipicamente 24-48 ore per una propagazione globale completa).

Distribuimentu multi-locazzioni

Per alta disponibilità è portata globale, cunsiderà u dispiegamentu in più posti:

Casi d'usu
  • Cuntinutu globali
  • Bilanciamentu di caricu geograficu
  • Ripristinu di disastru
  • Rispetta di li leggi di residenza di dati
  • Riduci a latenza pi l' utenti internaziunali
Impiegazzioni
  • Bilanciamentu di caricu basatu su DNS (GeoDNS)
  • Integrazione CDN (Cloudflare, ecc.)
  • Replica di database trà e regioni
  • Soluzioni di archiviazione cunnivisa
  • Failover a livellu di l'applicazzioni
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.