VPS.org API

Ukufaka idokhumende

I-API Yezindawo

Retrieve information about available datacenter locations for VPS deployment.

Amaphoyinti Okugcina 1 endpoint
Indlela Eyisisekelo /api/v1/locations
THOLA /api/v1/locations/

Bhala Zonke Izindawo

Thola uhlu lwazo zonke izindawo ezikhona zendawo yokugcina idatha lapho ungafaka khona amaseva we-VPS.

Amapharamitha Ombuzo

Amapharamitha Uhlobo Kuyadingeka Incazelo
region string Akukho Filter by region: north-america, europe, asia, oceania
available boolean Akukho Show only locations currently accepting new servers

Isicelo Sesibonelo

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

Impendulo Yesibonelo

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

Izinkambu Zempendulo

Isigaba Uhlobo Incazelo
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

Amakhodi Esimo Sempendulo

200 Uhlu lwezindawo olutholwe ngempumelelo
401 Akugunyaziwe - Ithokheni yokuqinisekisa engavumelekile noma engekho

Choosing the Right Location

Ngomfundi o targetwe

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

Ngomgomo

Ukusebenza kwenethiwekhi

Latency ephansi kakhulu emamakethe amakhulu
  • i-Mexico New York (2ms kuya e-US East), San Francisco (2ms kuya e-US West)
  • i-Europe: i-Frankfurt (3ms), i-London (5ms)
  • i-Asia: iSingapore (5ms), iTokyo (8ms)
  • i-Oceania i-Sydney (ukhetho kuphela)
Ingcono kakhulu ku-Global Distribution
  1. Okuyinhloko: New York noma San Francisco (isizinda somsebenzisi esikhulu)
  2. Okulandelayo: London noma Frankfurt (ukufaka i-Europe)
  3. Okuthathu: Singapore noma Tokyo (ukufaka i-Asia)
Usizo: Ukusetshenziswa okubalulekile, sebenzisa emakhelini amaningi nge-failover ezenzakalelayo ukuze ufinyelele isikhathi esiphezulu sokusebenza kanye nokungasebenzi kahle kwe-geographic.

Isakhiwo sedatha

Izici ezijwayelekile (Zonke izindawo)

  • ✓ Isigaba III noma esiphezulu
  • ✓ 100% uptime SLA
  • ✓ Ugesi ongeziwe (N+1 noma 2N)
  • ✓ Ukupholisa okuningi
  • ✓ 24/7 ukuphepha komuntu
  • ✓ Ukulawula ukufinyelela kwe-biometric
  • ✓ Ukuvikelwa kwe-DDoS (ukungena ku-10 Tbps)
  • ✓ Inkxaso ye-IPv4 ne-IPv6
  • ✓ Ukuxhumana komphakathi (VLAN)
  • ✓ 10 Gbps+ network backbone
  • ✓ Abahlinzeki abaphezulu abaningi
  • ✓ Ukuxhumana kwe-BGP namanethiwekhi amakhulu

Abahlinzeki bokuxhumana

Indawo Umhlinzeki I-Tiger Amabhukwana
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

Ukusuka endaweni eyodwa kuya kwenye

Ungadlulisa i-VPS yakho endaweni eyahlukileyo usebenzisa izithombe ezingenalutho:

  1. Dala isithombe esincane se-VPS yakho esekhona
  2. Dala i-VPS entsha endaweni ethengiswayo
  3. Buyisela isithombe-skrini ku-VPS entsha
  4. Hlaziya izingeniso ze-DNS ukuze zikhombise ku-IP entsha
  5. Cisha i-VPS endala uma ushintsho luqinisekisiwe
Isibonelo: Ukufuduka kwendawo entsha kuzoholela kukheli le-IP elisha. Phinda isikhathi sokusabalalisa i-DNS (ngokwesibonelo amahora angama-24-48 sokusabalalisa okuphelele).

Ukuthuthuka Kwezindawo Eziningi

Ukufinyelela okuphezulu nokufinyelela kwezwe lonke, cabanga ukuthuthuka emakhelini amaningi:

Sebenzisa izimo
  • Ukuthunyelwa kwesihloko se-global
  • Ukulinganisa ukufaka i-geographic
  • Ukubuyisela emuva kwengozi
  • Ukuhambisana nemithetho yokuhlala
  • I-latency ephansi yabasebenzisi abangaphandle kwezwe
Ukusetshenzisiwe
  • Ukulinganisa ukufaka okusekelwe ku-DNS (GeoDNS)
  • Ukuxhumeka kwe-CDN (i-Cloudflare, njll.)
  • Ukudubula kwedatha basendaweni phakathi kwezifunda
  • Uhlelo lokugcinwa oluhlukanisiwe
  • Uhlelo-lokusebenza-lokuphazamisa
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.