VPS.org API

REST API dokumentacija

API za lokacije

Retrieve information about available datacenter locations for VPS deployment.

Krajnje tačke 1 endpoint
Osnovni put /api/v1/locations
DOBITI /api/v1/locations/

Prikaži sve lokacije

Dohvati listu svih dostupnih lokacija podatkovnih centara gdje možete postaviti VPS servere.

Parametri upita

Parametar Tip Obavezno Opis
region string Ne, ne, ne. Filter by region: north-america, europe, asia, oceania
available boolean Ne, ne, ne. Show only locations currently accepting new servers

Primjer zahtjeva

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

Primjer odgovora

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

Polja za odgovor

Polje Tip Opis
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

Kodovi statusa odgovora

200 Uspješno preuzet popis lokacija
401 Neovlašteno - Nevažeći ili nedostajući token za autentifikaciju

Choosing the Right Location

Po ciljnoj publici

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

Po zahtjevima za usklađenošću

Mrežna performansa

Najniža latencija na glavnim tržištima
  • Sjeverna Amerika: New York (2ms do US Istoka), San Francisco (2ms do US Zapada)
  • Evropa: Frankfurt (3ms), London (5ms)
  • Azija: Singapur (5ms), Tokio (8ms)
  • Oceanija Sydney (samo opcija)
Najbolje za globalnu distribuciju
  1. Primarna: New York ili San Francisco (najveća baza korisnika)
  2. Sekundarni: London ili Frankfurt (pokrivenost Evrope)
  3. Tercijarno: Singapur ili Tokio (pokriva Aziju)
Savjet: Za kritične aplikacije, rasporedite na više lokacija sa automatskim failoverom za maksimalno vrijeme rada i geografsku redundanciju.

Infrastruktura podatkovnog centra

Standardne mogućnosti (sve lokacije)

  • ✓ Tier III ili viši podatkovni centri
  • ✓ 100% uptime SLA
  • ✓ Redundantna snaga (N+1 ili 2N)
  • ✓ Redundantno hlađenje
  • ✓ 24/7 fizičko osiguranje
  • ✓ Biometrijske kontrole pristupa
  • ✓ DDoS zaštita (do 10 Tbps ublažavanja)
  • ✓ Podrška za IPv4 i IPv6
  • ✓ Privatno umrežavanje (VLAN)
  • ✓ 10 Gbps+ mrežna okosnica
  • ✓ Više upstream davalaca usluga
  • ✓ BGP peering sa glavnim mrežama

Mrežni davaoci usluga

Lokacija Provider Životinje Bilješke
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

Pomicanje između lokacija

Možete migrirati svoj VPS na drugu lokaciju koristeći snimke:

  1. Napravite snimku vašeg postojećeg VPS-a
  2. Napravi novi VPS na ciljanoj lokaciji
  3. Obnovi snimku na novi VPS
  4. Ažuriraj DNS zapise da ukazuju na novi IP
  5. Obrišite stari VPS nakon što se migracija potvrdi
Napomena: Migracija na novu lokaciju će rezultirati novom IP adresom. Planirajte vrijeme DNS širenja (obično 24-48 sati za potpuno globalno širenje).

Multi-Location Deployment

Za visoku dostupnost i globalni doseg, razmislite o implementaciji na više lokacija:

Slučajevi upotrebe
  • Globalna isporuka sadržaja
  • Geografska ravnoteža opterećenja
  • Oporavak od katastrofe
  • Poštivanje zakona o boravištu podataka
  • Smanjena latencija za međunarodne korisnike
Implementacija
  • DNS-based load balancing (GeoDNS)
  • CDN integracija (Cloudflare, itd.)
  • Replikacija baze podataka preko regija
  • Shared storage solutions
  • Failover na nivou aplikacije
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.