VPS.org API

Dokumentace REST API

API pro umístění

Retrieve information about available datacenter locations for VPS deployment.

Koncové body 1 endpoint
Základní cesta /api/v1/locations
ZÍSKAT /api/v1/locations/

Zobrazit všechny lokality

Získejte seznam všech dostupných míst datového centra, kde můžete nasadit VPS servery.

Parametry dotazu

Parametr Typ Požadovaný Popis zboží
region string Ne. Filter by region: north-america, europe, asia, oceania
available boolean Ne. Show only locations currently accepting new servers

Příklad žádosti

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

Příklad odpovědi

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

Pole odpovědí

Pole Typ Popis zboží
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 odpovědi

200 Seznam lokalit byl úspěšně načten
401 Neoprávněné – Neplatný nebo chybějící ověřovací token

Choosing the Right Location

Podle cílové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

Požadavky na dodržování předpisů

Výkonnost sítě

Nejnižší shovívavost k významným trhům
  • Severní Amerika: New York (2ms to US East), San Francisco (2ms to US West)
  • Evropa: Frankfurt (3ms), Londýn (5ms)
  • Asie: Singapur (5ms), Tokio (8ms)
  • Oceánie: Sydney (pouze možnost)
Nejlepší pro globální distribuci
  1. Primární: New York nebo San Francisco (největší uživatelská základna)
  2. Sekundární: Londýn nebo Frankfurt (Evropa)
  3. Terciární: Singapur nebo Tokio (Asie pokrytí)
Pro Tip: U aplikací kritických pro misi se rozmístěte na několik míst s automatickým selháním pro maximální dobu provozu a geografickou redundanci.

Infrastruktura datového centra

Standardní vlastnosti (všechny lokality)

  • ✓ Úroveň III nebo vyšší datacentra
  • ✓ 100% uptime SLA
  • ✓ Redundantní výkon (N+1 nebo 2N)
  • ✓ Redundantové chlazení
  • ✓ 24/7 fyzická bezpečnost
  • ✓ Biometrické kontroly přístupu
  • ✓ Ochrana proti DDoS (do 10 Tbps zmírnění)
  • ✓ Podpora IPv4 a IPv6
  • ✓ Soukromé sítě (VLAN)
  • ✓ Síťová páteř 10 Gbps+
  • ✓ Poskytovatelé více protichůdných služeb
  • ✓ BGP peeling s hlavními sítěmi

Poskytovatelé sítě

Umístění Poskytovatel Úroveň 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

Pohyb mezi místy

Můžete přesunout VPS na jiné místo pomocí snímků:

  1. Vytvořte snímek existujícího VPS
  2. Vytvořit nové VPS v cílové lokalitě
  3. Obnovit snímek do nového VPS
  4. Aktualizovat záznamy DNS k ukazování na novou IP
  5. Smazat staré VPS po ověření migrace
Poznámka: Migrace na nové místo bude mít za následek novou IP adresu. Plán pro DNS čas šíření (obvykle 24-48 hodin pro plné globální šíření).

Multilokační nasazení

Pro vysokou dostupnost a globální dosah, zvažte nasazení na více místech:

Pouzdra na použití
  • Dodání globálního obsahu
  • Geografické vyvážení zatížení
  • Zotavování se z katastrofy
  • Dodržování právních předpisů o rezidenci údajů
  • Snížená latence pro mezinárodní uživatele
Provádění
  • Vyvažování zatížení na bázi DNS (GeoDNS)
  • CDN integrace (Cloudflare, atd.)
  • Reprodukce databází napříč regiony
  • Sdílené úložné roztoky
  • Selhání úrovně aplikace
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.