VPS.org API

Faʻamatalaga o le REST API

API o Nofoaga

Retrieve information about available datacenter locations for VPS deployment.

Fa'ai'uga 1 endpoint
Ala Autu /api/v1/locations
MAUA /api/v1/locations/

Lisi Nofoaga Uma

Toe maua se lisi o nofoaga uma o le datacenter e mafai ai ona e faʻaaogaina le VPS.

Fa'asologa o Fesili

Paramita Ituaiga Mana'omia Faʻamatalaga
region string E leai Filter by region: north-america, europe, asia, oceania
available boolean E leai Show only locations currently accepting new servers

Talosaga Fa'ata'ita'i

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

Tali Fa'ata'ita'i

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

Fanua Tali

Aoga Ituaiga Faʻamatalaga
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

Fa'ailoga o Tulaga o Tali

200 Lisi o nofoaga ua maua ma le manuia
401 E le'i Fa'atagaina - Fa'ailoga fa'amaonia e le aoga pe ua misi

Choosing the Right Location

E ala i le Faʻatonu

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

E ala i le Compliance Requirements

Faʻatinoina o le initaneti

Laiti Latency i le Major Markets
  • Amerika i Matu New York (2ms i le US East), San Francisco (2ms i le US West)
  • Europa: Frankfurt (3ms), London (5ms)
  • Asia: Singapore (5ms), Tokyo (8ms)
  • Oceania: Sydney (faʻatonu)
Lelei mo le Faʻaputuga Faʻavaomalo
  1. Faʻavae: New York po o San Francisco (faʻavae tagata faʻaoga sili)
  2. Faʻatolu: London po o Frankfurt (Europa coverage)
  3. Faʻatolu: Singapore po o Tokyo (Asia coverage)
Fautuaga: Mo talosaga mission-critical, faʻaaogaina i nofoaga eseese ma le failover otometi mo le taimi e faʻatapulaʻaina ai le taimi ma le faʻatapulaʻaina o le geographic.

Faavae o le Datacenter

Faʻamatalaga Faʻavae (Tutusiga uma)

  • ✓ Tier III po o nofoaga autu o faʻamatalaga maualuga atu
  • ✓ 100% Uptime SLA
  • ✓ Pusa faʻatapulaʻa (N+1 poʻo le 2N)
  • ✓ Faʻasusuga faʻasolosolo
  • ✓ 24/7 saogalemu faaletino
  • ✓ Faʻatonutonu faʻatinoga biometric
  • ✓ DDoS puipuiga (e oʻo atu i le 10 Tbps mitiia)
  • ✓ lagolago mo IPv4 ma IPv6
  • ✓ Faʻafesoʻotaʻiga faʻainitaneti faʻainitaneti (VLAN)
  • ✓ 10 Gbps + backbone fesoʻotaʻiga
  • ✓ Faʻatonu
  • ✓ BGP peering ma fesoʻotaʻiga tele

Faʻatauga o le 'au'aunaga'

Faʻafanua Faʻatonu Aperila Faʻamatalaga
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

Auina atu i le va o nofoaga

E mafai ona e feiloaʻi i lau VPS i se nofoaga ese e faʻaaoga ai ata:

  1. Faʻatulaga se ata o lau VPS ua i ai
  2. Faʻatulaga se VPS fou i le nofoaga o le faamoemoe
  3. Toe faʻaleleia le ata i le VPS fou
  4. Faʻafouina faʻamaumauga DNS e faʻasino i le IP fou
  5. Suʻe le VPS tuai pe a maeʻa le siakiina o le femalagaiga
Faʻamatalaga: O le femalagaiga i se nofoaga fou o le a mafua ai se tuatusi IP fou. Plan mo le taimi o le faʻamaʻi DNS (i le masani ai 24-48 itula mo le faʻamaʻi atoa).

Faʻaaogaina o nofoaga-faʻavasega

Mo le maualuga o le avanoa ma le alualu i luma i le lalolagi atoa, mafaufau i le faʻaaogaina i nofoaga eseese:

Faʻaaoga mataupu
  • Faʻaulufaleina o meatotino a le lalolagi
  • Faʻavasegaina o le faʻavasegaina o le faʻavasegaina
  • Toe faʻafoʻi mai le faʻalavelave
  • Faʻalagolago i tulafono o le nofomau o faʻamatalaga
  • Faʻaititia le le mautonu mo tagata faʻaoga i fafo
Faʻatino
  • Faʻavasegaina o le mamafa e faʻavae i luga o le DNS (GeoDNS)
  • Faʻatasiga CDN (Cloudflare, ma isi)
  • Faʻataʻitaʻiga o le database i le va o itulagi
  • Faʻamatalaga faʻafaigaluegaina
  • Failover i le tulaga o le talosaga
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.