VPS.org API

API- документација

API за локации

Retrieve information about available datacenter locations for VPS deployment.

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

Листај ги сите локации

Преземете ја листата на сите достапни локации на центарот на податоци каде што можете да распоредите VPS- сервери.

Параметри на барањето

Параметр Тип Задолжително Опис
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. Тертиар: Сингапур или Токио (покривање на Азија)
Проф. совет: За апликациите кои се критични за мисијата, распоредете ги на повеќе локации со автоматски неуспех за максимално зголемување и географско намалување.

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

Стандардни карактеристики (сите локацији)

  • ✓ Ниво III или повисоки центри за податоци
  • ✓ 100% временски СЛА
  • ✓ Напојување на резерви (N+1 или 2N)
  • ✓ Редундентно ладење
  • ✓ 24/7 физичка безбедност
  • ✓ Биометрички контроли на пристапот
  • ✓ DDOS заштита (до 10 Tbps ублажување)
  • ✓ Поддршка за IPv4 и IPv6
  • ✓ Приватна мрежа (VLAN)
  • ✓ 10 Gbps+ мрежен рбет
  • ✓ Повеќе провајдери нагоре по потокот
  • ✓ БГП разгледува со големи мрежи

Мрежни провајдери

Локација Доставувач Ниво Забелешки
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

Преместување меѓу локацијите

Можете да го мигрирате вашиот VPS на друга локација користејќи снимки:

  1. Креирајте снимка од вашиот постоечки VPS
  2. Креирај нова VPS во целта
  3. Врати ја снимката на новата VPS
  4. Ажурирај ги записите за DNS до укажување на новата IP
  5. Избриши го стариот VPS кога ќе се потврди миграцијата
Забелешка: Мигрирањето на нова локација ќе резултира со нова ИП адреса. План за време на размножување на DNS (обично 24- 48 часа за целосна глобална пропаганда).

Поставување на повеќе локацији

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

Случаи за користење
  • Глобална испорака на содржини
  • Географско балансирање на оптоварувањето
  • Закрепнување на катастрофите
  • Соодветност со законите за престој на податоци
  • Намалена латенција за меѓународните корисници
Имплементација
  • Балансирање на DNS- базирано натоварување (GeoDNS)
  • Интеграција на CDN (Cloudflare, итн.)
  • Репликација на базата на податоци низ регионите
  • Решувања за заедничко складирање
  • Неуспех на нивото на апликација
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.