VPS.org API

REST API skjölun

Staðsetningarforritaskil

Retrieve information about available datacenter locations for VPS deployment.

Endapunktar 1 endpoint
Grunnslóð /api/v1/locations
/api/v1/locations/

Listi yfir allar staðsetningar

Sækja lista yfir alla tiltæka gagnamiðstöðvarstaði þar sem þú getur dreift VPS netþjónum.

Fyrirspurnarbreytur

Breyta Tegund Nauðsynlegt Lýsing
region string Nei Filter by region: north-america, europe, asia, oceania
available boolean Nei Show only locations currently accepting new servers

Dæmi um beiðni

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

Dæmi um svar

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

Svarsvið

Field Tegund Lýsing
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

Kóðar fyrir svörunarstöðu

200 Listi yfir staðsetningar sóttur
401 Óheimilt - Ógilt eða vantar auðkenningarlykil

Choosing the Right Location

Eftir markhóp

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

Eftir kröfur um samræmi

NetframmistaðaName

Lægsta leynd til helstu markaðarins
  • Norður- Ameríka: New York (2ms til Austur-Ameríku), San Francisco (2ms til Vestur-Ameríku)
  • Evrópa: Frankfurt (3ms), London (5ms)
  • Asía: Singapore (5ms), Tókýó (8ms)
  • Eyjaálfa: Sydney (aðeins valkostur)
Best fyrir alþjóðlega dreifingu
  1. Aðal: New York eða San Francisco (stærsta notendagrunnur)
  2. Efri: London eða Frankfurt (Evrópu umfjöllun)
  3. Þriðja stig: Singapore eða Tokyo (Asíu umfjöllun)
Fyrir Ábending: Fyrir mikilvæg forrit skaltu dreifa á marga staði með sjálfvirkri veiru til að hámarka notkunartíma og landfræðilegan afgang.

Uppbygging gagnamiðstöðvar

Standard Lögun (Allar staðsetningar)

  • ✓ Tier III eða hærri gagnamiðstöðvar
  • ✓ 100% uppfærsla SLA
  • ✓ Óþarfa máttur (N + 1 eða 2N)
  • ✓ Óþarfa kæling
  • ✓ 24/7 líkamlegt öryggi
  • ✓ Líffræðileg aðgangsstýring
  • ✓ DDoS vörn (allt að 10 Tbps mildun)
  • ✓ IPv4 og IPv6 stuðningur
  • ✓ Einkanet (VLAN)
  • ✓ 10 Gbps + net bakgrunnur
  • ✓ Margir uppstreymisveitendur
  • ✓ BGP peering með helstu net

Netþjónustur

Staðsetning Veitendur Tími Athugasemdir
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

Færa á milli staða

Þú getur flutt VPS þinn á annan stað með því að nota skyndimyndir:

  1. Búðu til mynd af núverandi VPS þínum
  2. Búa til nýjan VPS á miða staðsetningu
  3. Endurheimta myndskeiðið á nýja VPS
  4. Uppfæra DNS færslur til að benda á nýja IP
  5. Eyða gömlu VPS þegar flutningur er staðfestur
Athugasemd: Skipuleggðu fyrir DNS útbreiðslu tíma (venjulega 24-48 klukkustundir fyrir fulla alþjóðlega útbreiðslu) og stöðvaðu útbreiðslu á nýjum stað.

Multi- staðsetning dreifing

Fyrir mikla framboð og alþjóðlega ná, íhuga að dreifa á mörgum stöðum:

Nota tilfelli
  • Alþjóðleg efnisveita
  • Landfræðileg álagsjöfnun
  • Slysa- endurheimt
  • Fylgni við lög um gagnaheimili
  • Minni leynd fyrir alþjóðlega notendur
Framkvæmd
  • DNS-undirstaða álagsjöfnun (GeoDNS)
  • CDN samþætting (Cloudflare osfrv.)
  • Gagnagrunnur afritunar á milli svæða
  • Sameiginlegar geymslulausnir
  • Forritastigi
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.