VPS.org API

REST 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 метра на запад)
  • Европа: Франкфурт (3ms), Лондон (5ms)
  • Азия: Сингапур (5ms), Токио (8ms)
  • Океания: Сидни (само опция)
Най-добро за глобално разпределение
  1. Основен: Ню Йорк или Сан Франциско (по-голяма потребителска база)
  2. Втори: Лондон или Франкфурт (Европейско покритие)
  3. Тертиар: Сингапур или Токио (покритие от Азия)
Професионален съвет: За приложения, които са критични за мисията, се разгръщат на няколко места с автоматичен провал за максимален срок на действие и географска редундантност.

Инфраструктура на Datacenter

Стандартни функции (всички местоположения)

  • ✓ Ниво III или по-високи центрове за данни
  • ✓ 100% почивно време СЛА
  • ✓ Преходна мощност (N+1 или 2N)
  • ✓ Редундентно охлаждане
  • ✓ 24/7 физическа сигурност
  • ✓ Биометричен контрол на достъпа
  • ✓ Защита на DDOS (до 10 Тб/с)
  • ✓ Поддръжка IPv4 и IPv6
  • ✓ Частна мрежа (VLAN)
  • ✓ 10 Gbps+ мрежов гръбнач
  • ✓ Много доставчици нагоре по течението
  • ✓ BGP с големи мрежи

Мрежови доставчици

Местоположение Доставчик Ниво на равнището Бележки
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 след проверка на миграцията
Забележка: Миграцията на ново място ще доведе до нов IP адрес. Планът за DNS време за размножаване (обикновено 24-48 часа за пълно глобално размножаване).

Внасяне на много места

За висока наличност и глобален обхват, разгледайте разпределението на няколко места:

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