VPS.org API

Dọkumenti

API Ọnọdụ

Retrieve information about available datacenter locations for VPS deployment.

Isi njedebe 1 endpoint
Ụzọ Ntọala /api/v1/locations
Nweta /api/v1/locations/

Depụta ebe niile

Weghachi ndesịta nke ebe datacenter niile dị na ị nwere ike ịrụnye VPS sava.

Paịmatị Ajụjụ

Paramita Ụdị A chọrọ Ndesịta ozi ndị ahụ
region string Ọ bụghị Filter by region: north-america, europe, asia, oceania
available boolean Ọ bụghị Show only locations currently accepting new servers

Arịrịọ Ihe Nlereanya

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

Ihe Nlereanya Azịza

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

Ubi Nzaghachi

_Òkè Ụdị Ndesịta ozi ndị ahụ
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

Koodu Ọnọdụ Nzaghachi

200 Enwetara ndepụta ebe nke ọma
401 Enweghị ikike - Akara njirimara na-ezighi ezi ma ọ bụ na-efu

Choosing the Right Location

Site n'omume

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

Site n'ihe mkpali

Nhazi netwọ́ọkụ

Latency ala ka Major Markets
  • North America New York (2ms ka US East), San Francisco (2ms ka US West)
  • Europe: Frankfurt (3ms), London (5ms)
  • Asia: Singapore (5ms), Tokyo (8ms)
  • Oceania Sydney (nhọrọ naanị)
Best maka Global Distribution
  1. P_irimal: New York mọọbụ San Francisco (ụdị ojieme kacha ukwuu)
  2. Sekọndịrị: London mọọbụ Frankfurt (Europe cover)
  3. Teŕíríà: Singapore mọọbụ Tokyo (Asia cover)
Ndụmọdụ: Maka ọrụ-critical usoroiheomume, depụta na ọtụtụ ebe na ọbụna failover maka kacha nta uptime na geospatial redundancy.

Datacenter Infrastructure

Nhazi ndị ahụ niile

  • ✓ Tier III mọọbụ datacenters dị elu
  • ✓ 100% uptime SLA
  • ✓ Ike na-abaghị uru (N+1 mọọbụ 2N)
  • ✓ Nchedo nke na-agaghị ekwe omume
  • ✓ 24/7 nchekwa
  • ✓ Nhazi ikikembanye bàiometric
  • ✓ DDoS nchekwa (na-eru 10 Tbps n'ịgwọta)
  • ✓ IPv4 na IPv6 nkwado
  • ✓ Nhazi netwọk nkeonwe (VLAN)
  • ✓ 10 Gbps+ netwọk backbone
  • ✓ Nhazi ndị ọzọ
  • ✓ BGP peering na netwọk ndị dị mkpa

Nhazi netwọk

Ebe Nhazi _Nhazi Ntụziaka
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

Kpụga n'etiti ebe ndị ahụ

I nwere ike ịgbanwe VPS gị gaa ebe ọzọ site na iji sịnmbụ:

  1. Kewapụta sịntịfaịlụ nke VPS gị dị ugbua
  2. Kewapụta VPS ọfụụ na ebe n'okporo ụzọ
  3. Weghachi sịnmpụ̀ na VPS ọfụụ
  4. Nhazigharịa DNS reshióọ̀sọ̀ ka ọ pụọ́ na IP ọfụụ
  5. Hichaa VPS ochie mgbe ịkwaga ahụ ekwenyela
Ndesịta ozi: Ntụgharị gaa ebe ọfụụ ga-eweta adreesị IP ọfụụ. Nhazi maka oge mmegharị DNS (dị ka 24-48 awa maka mmegharị zuru oke).

Nhazi ebe-ọtụtụ

Maka ike dị elu na n'ụwa nile, chee na ịrụpụta na ebe ndị dị iche iche:

Jiri ihenhọrọ ndị ahụ
  • Nhazi ihenhọrọ ndị ahụ
  • Nhazi n'ime ebe
  • Nnwale
  • Nnọọ n'ihe iwu data residency kwuru
  • Latency nke a wepụsịrị maka ndị ọrụ mba ọzọ
Nhazi
  • DNS-n'okpuru nrụnye n'otu n'otu (GeoDNS)
  • CDN n'ime (Cloudflare, wdg)
  • Ndesịta ozi ndị ahụ
  • Nchekwa nke emeredịkachọrọ
  • Usoroiheomume-nhazi failover
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.