VPS.org API

РЕСТЕПНА АПИ документација

API за локације

Retrieve information about available datacenter locations for VPS deployment.

Крајње тачке 1 endpoint
Основна путања /api/v1/locations
ДОБИЈ /api/v1/locations/

Наведите све локације

Добављајте списак свих доступних локација центра података где можете да покренете ВПС сервере.

Параметри упита

Параметар Тип Обавезно Опис
region string Не. Filter by region: north-america, europe, asia, oceania
available boolean Не. Show only locations currently accepting new servers

Пример захтева

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

Пример одговора

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

Поља за одговор

Поље Тип Опис
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

Кодови статуса одговора

200 Листа локација је успешно преузета
401 Неовлашћено - Неважећи или недостајући токен за аутентификацију

Choosing the Right Location

По циљу публика

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

По захт› јевима сагласности

Мрежна перформанса

Најнижа латенција на веће тржиште
  • Северна Америка: Њу Јорк (2 мс на исток САД), Сан Франциско (2мс на запад САД)
  • Европа: Франкфурт (3мс), Лондон (5мс)
  • Азија: Сингапур (5мс), Токио (8мс)
  • Океанија: Сиднеј (само опција)
Најбоља за глобалну дистрибуцију
  1. Примарно: Њујорк или Сан Франциско (највећа корисничка база)
  2. Секундарни: Лондон или Франкфурт (Европска покривеност)
  3. Тертиар: Сингапур или Токио (азијска покривеност)
Сав› јет проф.: За програме критичне за мисију, распоредите на више локација са аутоматским неуспехом за максимум временско и географско ослобађање.

Инфраструктура центра података

Стандардне могућности (све локације)

  • ✓ Трећи или виши центар података
  • ✓ 100% радно време СЛА
  • ✓ Напајање пром› јена (N+1 или 2N)
  • ✓ Редундант хлађење
  • ✓ 24/7 физичка безбедност
  • ✓ Контроле биометричког приступа
  • ✓ ДДОС заштита (до 10 Тбпс ублажавања)
  • ✓ Подршка за ИПв4 и ИПв6
  • ✓ Приватна мрежа (ВЛАН)
  • ✓ 10 Гбпс+ мрежна кичма
  • ✓ Вишеструки добављачи узводно
  • ✓ БГП гледање са великим мрежама

мрежни добављачи

Локација добављач Низ белешке
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

Премештање између локација

Можете преселити свој ВПС на другу локацију користећи снимке:

  1. Направи снимак вашег постојећег ВПС‐ а
  2. Направи нови ВПС на циљној локацији
  3. Обнови снимак на нови ВПС
  4. Ажурирај ДНС записе на нови ИП
  5. Брисање старог ВПС‐ а када се пров› јери миграција
Напомена: Мигрирање на нову локацију ће довести до нове ИП адресе. План за ДНС пропагирање (обично 24- 48 сати за пуну глобалну размножавање).

Постављање више локација

За високу доступност и глобални досег, размотрите распоред на више локација:

Случаји коришћења
  • Глобална испорука садржаја
  • Географско балансирање оптерећења
  • Опоравак са катастрофама
  • Подржавање са законима о пребивавању података
  • Смањена латенција за међународне кориснике
Имплементација
  • Балансирање утовара на основу ДНС‐ а (GeoDNS)
  • Интеграција ЦДН‐ а (Цлудфларе, итд.)
  • Множење базе података по регионима
  • Д› ијељена решења за складиштење
  • Неуспех на нивоу програма
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.