VPS.org API

REST API-dokumentation

Platser API

Retrieve information about available datacenter locations for VPS deployment.

Slutpunkter 1 endpoint
Basväg /api/v1/locations
/api/v1/locations/

Lista alla platser

Hämta en lista över alla tillgängliga datacenter platser där du kan distribuera VPS-servrar.

Frågeparametrar

Parameter Typ Nödvändig Varuslag
region string Ej tillämpligt Filter by region: north-america, europe, asia, oceania
available boolean Ej tillämpligt Show only locations currently accepting new servers

Exempelförfrågan

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

Exempelsvar

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

Svarsfält

Fält Typ Varuslag
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

Svarsstatuskoder

200 Platslistan har hämtats
401 Obehörig - Ogiltig eller saknad autentiseringstoken

Choosing the Right Location

Enligt målgruppen

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

Enligt kraven om överensstämmelse

Nätverksprestanda

Lägsta latens till större marknader
  • Nordamerika: New York (2ms to US East), San Francisco (2ms to US West)
  • Europa: Frankfurt (3ms), London (5ms)
  • Asien: Singapore (5 ms), Tokyo (8 ms)
  • Havskräfta: Sydney (endast alternativ)
Bästa för global distribution
  1. Primärt: New York eller San Francisco (största användarbasen)
  2. Sekundärt: London eller Frankfurt (Europatäckning)
  3. Högre utbildning: Singapore eller Tokyo (asientäckning)
Pro-tips: För uppdragskritiska applikationer, utplaceras till flera platser med automatisk felövergång för maximal drifttid och geografisk redundans.

Infrastruktur för datacenter

Standardfunktioner (alla platser)

  • ✓ Nivå III eller högre datacenter
  • ✓ 100 % drifttid SLA
  • ✓ Redundant effekt (N+1 eller 2N)
  • ✓ Redundant kylning
  • ✓ Dygnet runt fysisk säkerhet
  • ✓ Biometriska tillträdeskontroller
  • ✓ DDoS-skydd (upp till 10 Tbps-minimering)
  • ✓ Stöd för IPv4 och IPv6
  • ✓ Privata nätverk (VLAN)
  • ✓ 10 Gbps+-nätstomme
  • ✓ Flera uppströmsleverantörer
  • ✓ BGP-kontakter med stora nätverk

Nätverksleverantörer

Plats Leverantör Nivå Anmärkningar
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

Flytta mellan platser

Du kan migrera din VPS till en annan plats med hjälp av ögonblicksbilder:

  1. Skapa en ögonblicksbild av dina befintliga VPS
  2. Skapa en ny VPS på målplatsen
  3. Återställ ögonblicksbilden till den nya VPS
  4. Uppdatera DNS-poster för att peka på ny IP
  5. Ta bort gamla VPS när migreringen är verifierad
Anmärkning: Att flytta till en ny plats kommer att resultera i en ny IP-adress. Plan för DNS-utbredningstid (vanligtvis 24-48 timmar för full global utbredning).

Utplacering av flera platser

För hög tillgänglighet och global räckvidd, överväga utplacering på flera platser:

Användningsfall
  • Global tillhandahållande av innehåll
  • Geografisk belastningsbalansering
  • Katastrofåterställning
  • Efterlevnad av lagstiftningen om uppgiftsresidens
  • Minskad latens för internationella användare
Genomförande
  • DNS-baserad belastningsbalansering (GeoDNS)
  • Integrering av CDN (Cloudflare, etc.)
  • Databasreplikation mellan regioner
  • Delade lagringslösningar
  • Misslyckad programnivå
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.