VPS.org API

Dokumentado de REST API

Lokoj API

Retrieve information about available datacenter locations for VPS deployment.

Finpunktoj 1 endpoint
Baza Pado /api/v1/locations
AKIRU /api/v1/locations/

Listigi Ĉiujn Lokojn

Retiri liston de ĉiuj haveblaj datumcentraj lokoj kie vi povas disvolvigi VPS-servilojn.

Demandparametroj

Parametroj Tipo Bezonata Priskribo
region string No Filter by region: north-america, europe, asia, oceania
available boolean No Show only locations currently accepting new servers

Ekzempla Peto

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

Ekzempla Respondo

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

Respondaj Kampoj

Kampo Tipo Priskribo
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

Respondaj Statusaj Kodoj

200 Sukcese prenita listo de lokoj
401 Neaŭtorizita - Malvalida aŭ mankanta aŭtentiga ĵetono

Choosing the Right Location

Laŭ celo

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

Laŭ konformecpostuloj

Reta rendimentoName

Plej malalta latenteco al ĉefaj merkatoj
  • Nordameriko: New York (2ms al US East), San Francisco (2ms al US West)
  • Eŭropo: Frankfurto (3ms), Londono (5ms)
  • Azio: Singapuro (5ms), Tokio (8ms)
  • Oceanio Sydney (nur opcio)
@ title: window
  1. Unuaranga: New York aŭ San Francisco (plej granda uzanto bazo)
  2. Duaranga: Londono aŭ Frankfurto (Eŭropo)
  3. Terciara: Singapuro aŭ Tokio (Azio)
Pro- konsileto: Por misi-krizaj aplikoj, disvastigu al pluraj lokoj kun aŭtomata malsukceso por maksimuma funkciado kaj geografia redundo.

Datumcentra infrastrukturo

Normalaj ecoj (ĉiuj lokoj)

  • ✓ Datumcentroj de nivelo III aŭ pli alta
  • ✓ 100% SLA
  • ✓ Rezerva potenco (N+1 aŭ 2N)
  • ✓ Rezerva malvarmigo
  • ✓ 24/7 fizika sekureco
  • ✓ Biometriaj alirkontroloj
  • ✓ DDoS- protekto (malhelpo ĝis 10 Tbps)
  • ✓ IPv4 kaj IPv6 subteno
  • ✓ Privata reto (VLAN) Name
  • ✓ 10 Gbps+ reta dorso
  • ✓ Pluraj provizantoj
  • ✓ BGP-kuniĝo kun ĉefaj retoj

Retprovizantoj

@ title: column Provizanto Tamuz Notoj
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

Movi inter lokoj

Vi povas migri vian VPS al alia loko uzante momentfotojn:

  1. Krei bildon de via ekzistanta VPS
  2. Krei novan VPS en la cela loko
  3. Restaŭri la momentobildon al la nova VPS
  4. Ĝisdatigi DNS- erojn por montri al nova IP
  5. Forigi malnovan VPS post kiam la translokigo estas kontrolita
Note: Migrado al nova loko rezultigos novan IP- adreson. Planu la DNS- disvastiĝotempon (tipike 24- 48 horojn por plena tutmonda disvastiĝo).

Plurloka disvastigo

Por alta disponeblo kaj tutmonda atingo, konsideru disvastigon en pluraj lokoj:

Uzkazoj
  • Tutmonda enhavo- liverado
  • Geografia ŝarĝekvilibro
  • Katastrofa rekupero
  • Konformo kun datum-loĝaj leĝoj
  • Malpliigita prokrasto por internaciaj uzantoj
Realigo
  • DNS-bazita ŝarĝekvilibro (GeoDNS)
  • CDN-integriĝo (Cloudflare, ktp.)
  • Reproduktado de datumbazo tra regionoj
  • Komunaj stokado-solvoj
  • Aplikaĵonivela fiasko
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.