VPS.org API

Uxwebhu lwe-REST API

I-API yeendawo

Retrieve information about available datacenter locations for VPS deployment.

Iindawo zokugqibela 1 endpoint
Indlela Esisiseko /api/v1/locations
FUMANA /api/v1/locations/

Dwelisa Zonke Iindawo

Fumana uluhlu lweendawo zonke ezifumanekayo zedatacenter apho ungasebenzisa khona iiseva ze VPS.

IiParamitha zoMbuzo

Iparamitha Uhlobo Kufuneka Inkcazelo
region string Akukho nanye Filter by region: north-america, europe, asia, oceania
available boolean Akukho nanye Show only locations currently accepting new servers

Isicelo somzekelo

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 yoMzekelo

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

IiNdawo zeMpendulo

Iindawo Uhlobo Inkcazelo
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

Iikhowudi zeMeko yokuphendula

200 Uluhlu lweendawo olufunyenwe ngempumelelo
401 Ayigunyaziswanga - Ithokheni yokuqinisekisa engasebenziyo okanye engekhoyo

Choosing the Right Location

Ngenjongo

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

Iinkqubo zolawulo

Umsebenzi womnathaComment

Ixesha elifutshane lokulibaziseka kumashishini amakhulu
  • Umntla Melika: New York (2ms ukuya eMpuma yase-US), San Francisco (2ms ukuya eMpuma yase-US)
  • EYuropu: Frankfurt (3ms), London (5ms)
  • Asia: Singapore (5ms), Tokyo (8ms)
  • Oceania: Sydney (ukhetho kuphela)
Ilungele Unikezelo Lwehlabathi
  1. Ephambili: New York okanye San Francisco (isiseko somsebenzisi esikhulu)
  2. Ezantsi: London okanye Frankfurt (ukulinganisa iYuropu)
  3. I-Tertiary: Singapore okanye Tokyo (ukukhokela eAsia)
Icebo: Ukusetyenziswa kwemisebenzi ebalulekileyo, unikezelo kumaziko amaninzi ngenkqubo ekhawulezayo yokuyeka ukusebenza ukuze kufezekiswe ixesha elininzi lokuqhubeka nokusebenza kunye nokungasebenzi kakuhle kwendawo.

Iinkqubo ze-Datacenter

Iimpawu Ezisezantsi (Zonke iindawo)

  • ✓ Iindawo zokugcina idatha ezikwinqanaba III okanye ngaphezulu
  • ✓ 100% uptime SLA
  • ✓ Amandla angaphezulu (N+1 okanye 2N)
  • ✓ Ukufudumeza okuninzi
  • ✓ Ukhuseleko olubonakalayo
  • ✓ Ulawulo lokungena lwe-biometric
  • ✓ Ukhuseleko lwe-DDoS (ukufikelela kwi-10 Tbps yokunciphisa)
  • ✓ Inkxaso ye IPv4 ne IPv6
  • ✓ Uthungelwano lwabucala (VLAN)
  • ✓ 10 Gbps+ uthungelwano lwemisonto
  • ✓ Ababoneleli abaphezulu abaninzi
  • ✓ I-BGP idibanisa nenethiwekhi enkulu

Ababoneleli ngothungelwano

Indawo Umboneleli I-Tier Iinkcukacha
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

Ukuhamba phakathi kweendawo

Ungafudusa i-VPS yakho kwindawo eyahlukileyo usebenzisa imifanekiso eqingqiweyo:

  1. Dala umfanekiso ongumqondiso we-VPS yakho esele ikhona
  2. Dala i-VPS entsha kwindawo emiselweyo
  3. Buyisela umfanekiso okhawulezayo kwi-VPS entsha
  4. Hlela iirekhodi ze-DNS ukuze zikhokelele kwi-IP entsha
  5. Cima i-VPS endala xa utshintshiselwano luqinisekisiwe
& Incwadi eneenkcukacha Entsha... Ukufuduka kwindawo entsha kuzakubangela idilesi entsha ye IP. Phanda ixesha lokusasaza le DNS (ihlala iyure ezili-24-48 zokusasaza okupheleleyo kwehlabathi liphela).

Unikezelo lweendawo ezininzi

Ukufumana ukufikelela okuphezulu kunye nokufikelela kwihlabathi liphela, qaphela ukubekwa kwiindawo ezininzi:

Iimeko Zokusetyenziswa
  • Unikezelo lwezinto eziquletheyo
  • Ukulungelelanisa ubunzima bendawo
  • Ukubuyiswa kweengxaki
  • Ukulandela umthetho wokuhlala kwedatha
  • I-latency ephantsi yabasebenzisi abaphesheya
Inkqubo yolawulo
  • Ulinganiso lokufaka olusekelwe kwi-DNS (GeoDNS)
  • Uthungelwano lwe-CDN (i-Cloudflare, njl.njl.)
  • Ukuphindaphinda kwe-database phakathi kwamaphondo
  • Iinkqubo zokugcina ezidityanisiweyo
  • Inkqubo yokusebenza-ephakamileyo ye failover
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.