VPS.org API

REST API Documentation

API ya Malo

Retrieve information about available datacenter locations for VPS deployment.

Mapeto 1 endpoint
Njira Yoyambira /api/v1/locations
Pezani /api/v1/locations/

Lembani Malo Onse

Pezani mndandanda wa ma datacenter onse omwe alipo komwe mungagwiritse ntchito ma seva a VPS.

Ma Parameter a Mafunso

Paramita Mtundu Zofunika Kufotokozera
region string Si Filter by region: north-america, europe, asia, oceania
available boolean Si Show only locations currently accepting new servers

Chitsanzo cha Pempho

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

Chitsanzo cha Yankho

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

Mayankho a Minda

Kuwala Mtundu Kufotokozera
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

Makhodi a Mkhalidwe Woyankha

200 Ndapeza bwino mndandanda wa malo
401 Wosaloledwa - Chizindikiro chovomerezeka chosayenera kapena chomwe chikusowa

Choosing the Right Location

Pogwiritsa ntchito Target Audience

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

Pogwiritsa ntchito zofunikira zogwirizana

Kugwira ntchito pa netiweki

Lowest Latency kwa Major Markets
  • North America: New York (2ms ku US East), San Francisco (2ms ku US West)
  • Europe: Frankfurt (3ms), London (5ms)
  • Asia: Singapore (5ms), Tokyo (8ms)
  • Oceania Sydney (chokha chitsanzo)
Best kwa Global Kugawa
  1. Primary: New York kapena San Francisco (kugwiritsa ntchito kwakukulu)
  2. Chigawo: London kapena Frankfurt (Europe kukhudza)
  3. Tertiary: Singapore kapena Tokyo (Asia kukhudza)
Chidule: Kwa ntchito zofunikira pantchito, gwiritsani ntchito masamba ambiri ndi failover yokhayokha kuti muchepetse nthawi yogwira ntchito komanso kuwonjezeka kwachikhalidwe.

Kukhazikitsa kwa Datacenter

Standard Features (Zosefera zonse)

  • ✓ Tier III kapena ma datacenters opitilira
  • ✓ 100% uptime SLA
  • ✓ Kuwonjezeka mphamvu (N + 1 kapena 2N)
  • ✓ Kutentha kwa redundant
  • ✓ 24/7 chitetezo cha thupi
  • ✓ Kuwongolera kwa biometric
  • ✓ Kuteteza kwa DDoS (kupitilira 10 Tbps kuchepetsa)
  • ✓ Kuthandizira kwa IPv4 ndi IPv6
  • ✓ Kulumikizana kwapadera (VLAN)
  • ✓ 10 Gbps + backbone ya netiweki
  • ✓ Othandizira ambiri a upstream
  • ✓ BGP peering ndi ma network akulu

Othandizira netiweki

Malo Wopereka Mtundu Zikumbutso
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

Kusintha pakati pa malo

Mukhoza kunyamula VPS yanu ku malo osiyanasiyana pogwiritsa ntchito zithunzi:

  1. Pangani chithunzi cha VPS yanu yomwe ilipo
  2. Kukhazikitsa VPS yatsopano pamalo osankhidwa
  3. Kubwezeretsa snapshot ku VPS yatsopano
  4. Kusintha DNS records kuti ziwonetsere ku IP yatsopano
  5. Sungani VPS yakale pamene kunyamula kutsimikiziridwa
Kukumbukira: Kusintha kwa malo atsopano kudzakhala ndi adilesi yatsopano ya IP.Place nthawi yofalitsa DNS (mwachitsanzo, 24-48 maola kwa kufalitsa kwa dziko lonse).

Kugwiritsa ntchito malo ambiri

Kwa kupezeka kwakukulu ndi kupezeka kwa padziko lonse, ganizirani kukhazikitsa m'madera ambiri:

Kugwiritsa ntchito Malamulo
  • Kutumiza kwazinthu zapadziko lonse lapansi
  • Kuwongolera kwachikhalidwe
  • Kubwezeretsa kwa ziwopsezo
  • Kutsatira malamulo a data akukhala
  • Kuchepetsa latency kwa ogwiritsa ntchito akunja
Kugwiritsa ntchito
  • Kuwongolera kwa DNS-kutengera kulemera (GeoDNS)
  • Kuphatikiza kwa CDN (Cloudflare, etc.)
  • Database kufalitsa pakati pa mizinda
  • Zosankha zogawana zosunga zobwezeretsera
  • Failover pa level ya pulogalamu
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.