VPS.org API

REST API dokumentáció

Helyszínek API

Retrieve information about available datacenter locations for VPS deployment.

Végpontok 1 endpoint
Alapút /api/v1/locations
KAP /api/v1/locations/

Összes helyszín listázása

Szerezzen listát az összes rendelkezésre álló adatközponti helyről, ahol a VPS szervereket telepítheti.

Lekérdezési paraméterek

Paraméter Típus Kívánt Leírás
region string Nem. Filter by region: north-america, europe, asia, oceania
available boolean Nem. Show only locations currently accepting new servers

Példa kérés

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

Példaválasz

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

Válaszmezők

Mező Típus Leírás
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

Válasz állapotkódok

200 Helyszínlista sikeresen lekérve
401 Jogosulatlan - Érvénytelen vagy hiányzó hitelesítési token

Choosing the Right Location

Célközönség által

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

Megfelelési követelmények

Hálózati teljesítmény

Legalacsonyabb olvashatóság a Major Markets számára
  • Észak-Amerika: New York (2ms US East), San Francisco (2ms US West)
  • Európa: Frankfurt (3ms), London (5ms)
  • Ázsia: Szingapúr (5ms), Tokió (8ms)
  • Óceánia: Sydney (csak lehetőség)
A legjobb a globális disztribúciónak
  1. Elsődleges: New York vagy San Francisco (legnagyobb felhasználói bázis)
  2. Másodlagos: London vagy Frankfurt (Európa lefedettsége)
  3. Territory: Szingapúr vagy Tokió (Ázsia lefedettség)
Pro Tipp: Küldetés-kritikus alkalmazások esetén több olyan helyre kell bevetni, ahol a maximális üzemidő és földrajzi redundancia automatikus üzemképtelen.

Adatközponti infrastruktúra

Standard funkciók (Minden hely)

  • ✓ Tier III vagy magasabb adatközpont
  • ✓ 100%-os üzemidő SLA
  • ✓ Redundáns teljesítmény (N+1 vagy 2N)
  • ✓ Reundáns hűtés
  • ✓ 24/7 fizikai biztonság
  • ✓ Biometrikus hozzáférés-ellenőrzések
  • ✓ DDoS védelem (legfeljebb 10 Tbps mérséklés)
  • ✓ IPv4 és IPv6 támogatás
  • ✓ Privát hálózatépítés (VLAN)
  • ✓ 10 Gbps+ hálózati gerinc
  • ✓ Több upstream szolgáltató
  • ✓ A BGP a főbb hálózatokkal való egyeztetése

Hálózati szolgáltatók

Hely Szolgáltató Tier Megjegyzések
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

Mozgás a helyszínek között

A VPS-t egy másik helyre viheti át pillanatfelvételek segítségével:

  1. Készítsen egy pillanatképet a meglévő VPS-jéről
  2. Új VPS létrehozása a célhelyen
  3. A fénykép visszaállítása az új VPS-hez
  4. A DNS-rekordok frissítése az új IP-címre
  5. A régi VPS törlése a migráció ellenőrzése után
Megjegyzés: Az új helyre történő migráció új IP-címet eredményez. A DNS-szaporodási idő terve (jellemzően 24-48 óra a teljes globális szaporításhoz).

Több helyszínen történő telepítés

A nagy rendelkezésre állás és a globális elérés érdekében fontolja meg a több helyszínen történő telepítést:

Esetek használata
  • Globális tartalomszolgáltatás
  • Földrajzi terhelés egyensúlyozása
  • Katasztrófaelhárítás
  • Az adatrezidensekre vonatkozó jogszabályoknak való megfelelés
  • Csökkentett késleltetés nemzetközi felhasználók számára
Végrehajtás
  • DNS-alapú terhelésegyensúlyozás (GeoDNS)
  • CDN integráció (Cloudflare, stb.)
  • Adatbázis-replikáció régiók között
  • Megosztott tárolási oldatok
  • Alkalmazásszintű sikertelenség
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.