API pre lokality

ZÍSKAŤ /api/v1/locations/

Zoznam všetkých lokalít

Získajte zoznam všetkých dostupných dátových centier, kde môžete nasadiť servery VPS.

Parametre dopytu

Parameter	Typ	Povinné	Opis
`region`	string	Nie	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	Nie	Show only locations currently accepting new servers

Príklad žiadosti

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

Príklad odpovede

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

Polia odpovede

Pole	Typ	Opis
`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

Kódy stavu odpovede

200	Zoznam lokalít bol úspešne načítaný
401	Neoprávnené – neplatný alebo chýbajúci autentifikačný token

Choosing the Right Location

Podľa cieľového publika

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

Podľa požiadaviek na súlad

GDPR (ochrana osobných údajov EÚ): London, Frankfurt
Údaje o pobyte v USA: New York, San Francisco
Kanadská suverenita dát: Toronto
APAC Data Residency: Singapore, Tokyo, Sydney

Výkon siete

Najnižšia latencia na hlavných trhoch

Severná Amerika: New York (2ms na východ USA), San Francisco (2ms na západ USA)
Európa: Frankfurt (3ms), Londýn (5ms)
Ázia: Singapur (5ms), Tokio (8ms)
Oceánia: Sydney (iba možnosť)

Najlepšie pre globálnu distribúciu

Primárne: New York alebo San Francisco (najväčšia užívateľská základňa)
Sekundárne: Londýn alebo Frankfurt (pokrytie Európy)
Terciárne: Singapur alebo Tokio (pokrytie Ázie)

Pre Tip: Pre kritické aplikácie nasadiť na viacerých miestach s automatickým prechodom na iné zariadenie pre maximálnu prevádzkyschopnosť a geografickú redundanciu.

Infraštruktúra dátového centra

Štandardné funkcie (všetky lokality)

✓ Dátové centrá Tier III alebo vyššie
✓ 100% dostupnosť SLA
✓ Redundantné napájanie (N+1 alebo 2N)
✓ • Redundantné chladenie
✓ 24/7 fyzická bezpečnosť
✓ Biometrické kontroly prístupu

✓ Ochrana DDoS (mitigačné riešenie až do 10 Tbps)
✓ Podpora protokolov IPv4 a IPv6
✓ Súkromné siete (VLAN)
✓ 10 Gbps+ sieťová chrbtica
✓ Viacerí poskytovatelia upstream
✓ BGP peering s hlavnými sieťami

Poskytovatelia sieťových služieb

Umiestnenie	Poskytovateľ	Zvieratá	Poznámky
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

Presun medzi lokalitami

Váš VPS môžete migrovať na iné miesto pomocou snímok:

Vytvorte si snímku vášho existujúceho VPS
Vytvorenie nového VPS v cieľovej lokalite
Obnovenie snímky na nový VPS
Aktualizácia záznamov DNS tak, aby smerovali na novú adresu IP
Po overení migrácie zmažte starý VPS

Poznámka: Naplánujte si čas šírenia DNS (zvyčajne 24 až 48 hodín pre úplné globálne šírenie), ktorý sa bude odvíjať od toho, ako rýchlo sa bude doména šíriť.

Nasadenie na viacerých miestach

Ak chcete dosiahnuť vysokú dostupnosť a globálny dosah, zvážte nasadenie na viacerých miestach:

Prípady použitia

Globálne doručovanie obsahu
Geografické vyvažovanie záťaže
Obnova po havárii
Dodržiavanie zákonov o rezidencii údajov
Znížená latencia pre medzinárodných používateľov

Vykonávanie

Vyvažovanie zaťaženia na báze DNS (GeoDNS)
Integrácia CDN (Cloudflare, atď.)
Replikácia databázy v rôznych regiónoch
Riešenia zdieľaného úložiska
Failover na úrovni aplikácie

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

VPS.org API