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

Замони интизоршавии пасттарин ба бозорҳои калон
  • Амрикои Шимолӣ Ню Йорк (2ms ба шарқи ИМА), Сан- Франциско (2ms ба ғарби ИМА)
  • Аврупо: Франкфурт (3ms), Лондон (5ms)
  • Осиё: Сингапур (5 мс), Токио (8 мс)
  • Океания: Сидни (танҳо вариант)
Беҳтарин барои тақсимоти глобалӣ
  1. Асосӣ: Ню- Йорк ё Сан- Франциско (базаи калонтарини корбарон)
  2. Дуюмдараҷа: Лондон ё Франкфурт (пӯшиши Аврупо)
  3. Сеюм: Сингапур ё Токио (пӯшиши Осиё)
Маслиҳат: Барои барномаҳои муҳими вазифа, ба бисёр ҷойҳо бо фаъолсозии худкор барои вақти максималӣ ва гео-резервӣ ҷойгир кунед.

Инфраструктураи Маркази Маълумот

Хусусиятҳои стандартӣ (Ҳамаи ҷойгиршавӣ)

  • ✓ Дараҷаи III ё баландтар
  • ✓ 100% вақти корӣ SLA
  • ✓ Нерӯи зиёдатӣ (N+1 ё 2N)
  • ✓ Хобгарии зиёдатӣ
  • ✓ Амният
  • ✓ Идоракунии дастрасии биометрӣ
  • ✓ Муҳофизати DDoS (то 10 Tbps)
  • ✓ Пуштибонии IPv4 ва IPv6
  • ✓ Шабакаи хусусӣ (VLAN) Name
  • ✓ 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.