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 Tbps хүртэл)
  • ✓ IPv4 болон IPv6 дэмжлэг
  • ✓ Хувийн сүлжээ (VLAN)
  • ✓ 10Gbps+ сүлжээний нугасны сүлжээ
  • ✓ Олон тооны эх үүсвэр
  • ✓ Бүрэн сүлжээний 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. Шинэ IP хаягийг харуулах DNS бүртгэлийг шинэчил
  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.