Lokaasjes API

KRIJE /api/v1/locations/

List alle lokaasjes

In list fan alle beskikbere lokaasjes fan datasintrums ophelle wêr't jo VPS-tsjinners ynsette kinne.

Fraachparameters

Parameters	Type	Ferplicht	Beskriuwing
`region`	string	Net	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	Net	Show only locations currently accepting new servers

Foarbyldfersyk

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

Foarbyldantwurd

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

Antwurdfjilden

Fjild	Type	Beskriuwing
`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

Antwurdstatuskoades

200	Lokaasjelist mei súkses ophelle
401	Net autorisearre - Unjildich of ûntbrekkend autentikaasjetoken

Choosing the Right Location

Neffens doelgroep

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

Neffens de easken

GDPR (EU gegevensbeskerming): London, Frankfurt
US Data Residency: New York, San Francisco
Kanadeeske gegevenssoevereiniteit: Toronto
Data- residinsje: Singapore, Tokyo, Sydney

NetwurkprestaasjesName

Leechst mooglike fertraging foar grutte merk

Noard- Amearika: New York (2ms nei US East), San Francisco (2ms nei US West)
Europa: Frankfurt (3ms), Londen (5ms)
Azië: Singapoer (5ms), Tokio (8ms)
Oceanië: Sydney (allinnich opsje)

Best foar globale distribúsje

Primêre: New York of San Francisco (grutste brûkersbasis)
Sekondêre: Londen of Frankfurt (Europa dekking)
Tertiêr: Singapore or Tokyo (Asia dekking)

Tip: Foar misjekrityske applikaasjes, ynsette op meardere lokaasjes mei automatyske failover foar maksimale uptime en geografyske redundansje.

Datasintrum ynfrastruktuer

Standertfunksjes (alle lokaasjes)

✓ Tier III of hegere datasintrums
✓ 100% uptime SLA
✓ Redundant power (N+1 or 2N)
✓ Redundant koeling
✓ 24/ 7 fysieke befeiliging
✓ Biometriske tagongskontrôles

✓ DDoS- beskerming (oant 10 Tbps)
✓ IPv4 en IPv6 stipe
✓ Privé netwurking (VLAN) Name
✓ 10 Gbps+ netwurk backbone
✓ Meardere upstream- oanbieders
✓ BGP peering mei grutte netwurken

Netwurkferskaffers

Lokaasje	Ferskaffer	fan Adar	Notysje
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

Tusken lokaasjes bewege

Jo kinne jo VPS nei in oare lokaasje migrearje mei help fan snapshots:

Meitsje in snapshot fan jo besteande VPS
In nije VPS oanmeitsje op de doellokaasje
De snapshot weromsette nei de nije VPS
DNS- records bywurkje om nei nij IP- adres te wizen
Alde VPS wiskje as de migraasje befêstige is

Notysje: It ferpleatsen nei in nije lokaasje sil resultearje yn in nij IP- adres. Plan de tiid foar de DNS- fersprieding (meastal 24- 48 oeren foar in folsleine wrâldwiid fersprieding).

Multi- lokaasje ynset

Foar hege beskikberens en wrâldwiid berik, oerweeg it ynsetten op meardere lokaasjes:

Gebrûksgefallen

Globale ynhâldôflevering
Geografyske ladingsferdieling
Nûmer fan it wachtwurd
Oanpassing oan wetten foar gegevensferbliuw
Redusearre latentie foar ynternasjonale brûkers

Implementaasje

DNS- basearre ladingsferdieling (GeoDNS)
CDN- yntegraasje (Cloudflare, ensfh.)
Databankreplikaasje oer regio's
Dield opslach
Failover op applikaasjenivo

Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.

VPS.org API