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

Сапалы талаптар бойынша

Желі жылдамдығыName

Негізгі нарықтарға ең төменгі кешіктіру
  • Солтүстік Америка: Нью- Йорк (2мс АҚШ шығысына), Сан- Франциско (2мс АҚШ батысын)
  • Еуропа: Франкфурт (3мс), Лондон (5мс)
  • Азия: Сингапур (5мс), Токио (8мс)
  • Океания: Сидней (тек таңдау)
Жалпы тарату үшін ең жақсысы
  1. Негізгі: Нью- Йорк не Сан- Франциско (ең көп қолданушылар)
  2. Екінші: Лондон не Франкфурт (Еуропа)
  3. Үшінші: Сингапур немесе Токио (Азия)
Кеңес: Критикалық қолданбалар үшін, автоматты түрде бірнеше орынға орналастыру, жұмыс уақытын және географиялық резервті арттыру.

Деректер орталығының инфрақұрылымы

Стандартты мүмкіндіктер (барлық орындарға)

  • ✓ III немесе жоғары деңгейдегі деректер орталықтары
  • ✓ 100% жұмыс істеу уақыты SLA
  • ✓ Қосымша қуат (N+1 не 2N)
  • ✓ Қатесіз салқындату
  • ✓ 24/7 физикалық қауіпсіздік
  • ✓ Қатынауды биометриялық басқару
  • ✓ DDoS шабуылынан қорғау (10 Тб/ с- қа дейін)
  • ✓ IPv4 және IPv6 қолдауы
  • ✓ Жеке желі (VLAN) Name
  • ✓ 10 Гб/ с+ желі арқалығы
  • ✓ Бірнеше провайдерлер
  • ✓ Негізгі желілермен 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, т.б.)
  • Деректер қорын өңірлер арасында репликациялау
  • Ортақ сақтау шешімдеріName
  • Қолданба деңгейіндегі қайта жүктеу
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.