VPS.org API

REST API- dokumentasjon

Steder API

Retrieve information about available datacenter locations for VPS deployment.

Endepunkter 1 endpoint
Basissti /api/v1/locations
BLI /api/v1/locations/

List opp alle steder

Hent en liste over alle tilgjengelige datasentersteder der du kan installere VPS- tjenere.

Spørringsparametere

Parameter Type Obligatorisk Beskrivelse
region string Nei Filter by region: north-america, europe, asia, oceania
available boolean Nei Show only locations currently accepting new servers

Eksempelforespørsel

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

Eksempelsvar

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

Svarfelt

Felt Type Beskrivelse
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

Svarstatuskoder

200 Hentet stedsliste
401 Uautorisert – Ugyldig eller manglende autentiseringstoken

Choosing the Right Location

Etter mållyd

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

Etter krav til samsvar

Nettverkets ytelse

Laveste forsinkelse til større markeder
  • Nord- Amerika: New York (2ms til US East), San Francisco (2ms til US West)
  • Europa: Frankfurt (3ms), London (5ms)
  • Asia: Singapore (5 ms), Tokyo (8 ms)
  • Oseania: Sydney (bare valg)
Best for global distribusjon
  1. Primær: New York eller San Francisco (største brukerbase)
  2. Sekundær: London eller Frankfurt (Europas dekning)
  3. Tertiær: Singapore eller Tokyo (Asia-dekning)
Pro- tips: For missionskritiske anvendelser, settes i drift på flere steder med automatisk feiloverføring for maksimal opptid og geografisk redundans.

Datasenterinfrastruktur

Standardegenskaper (alle steder)

  • ✓ Nivå III eller høyere datasentre
  • ✓ 100% opp-tid SLA
  • ✓ Redundant effekt (N+1 eller 2N)
  • ✓ Rødluftskjøling
  • ✓ Fysisk sikkerhet 24/7
  • ✓ Kontrollinnretninger for biometrisk adgang
  • ✓ DDoS-beskyttelse (opptil 10 Tbps-reduksjon)
  • ✓ Støtte for IPv4 og IPv6
  • ✓ Privat nettverk (VLAN)
  • ✓ 10 Gbps+ nett ryggrad
  • ✓ Flere leverandører i oppstrøms
  • ✓ BGP- peerering med større nettverk

Nettverksleverandører

Plassering Leverandør Nivå Merknader
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

Flytter mellom steder

Du kan overføre VPS til et annet sted ved hjelp av skjermbilder:

  1. Lag et skjermbilde av din eksisterende VPS
  2. Opprett en ny VPS på mål- stedet
  3. Gjenopprett skjermbildet til det nye VPS
  4. Oppdater DNS- oppføringer for å peke til ny IP
  5. Slett gammel VPS når migrasjonen er verifisert
Merk: Overføring til et nytt sted vil gi en ny IP- adresse. Plan for DNS- spredningstid (vanligvis 24- 48 timer for full global spredning).

Flerplasserings- utbygging

For å oppnå høy tilgjengelighet og global rekkevidde, overvei å innføre følgende på flere steder:

Brukstilfeller
  • Levering av globalt innhold
  • Geografisk lastbalansering
  • Katastrofegjenvinning
  • Overholdelse av lovgivningen om opplysningers opphold
  • Redusert latens for internasjonale brukere
Gjennomføring
  • DNS-basert lastbalansering (GeoDNS)
  • integrasjon av CDN (skyflare osv.)
  • Databaseintroduksjon i regioner
  • Delte lagringsløsninger
  • Feil på programnivå
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.