Жайгашкан жерлер API'си

АЛУУ /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

Соответствие требованиям

Маалыматтарды коргоо London, Frankfurt
АКШ New York, San Francisco
Канадалык маалымат суверенитети: Toronto
АПК маалыматынын жайгашкан жери: Singapore, Tokyo, Sydney

Тармактын иштөөсү

Эң төмөн кечиктирүү

Түндүк Америка Нью-Йорк (2 мс АКШ чыгышына), Сан-Франциско (2 мс АКШ батышына)
Европа: Франкфурт (3ms), Лондон (5ms)
Азия: Сингапур (5 мс), Токио (8 мс)
Океания: Сидней (бир гана вариант)

Глобалдык жайылтуу үчүн эң жакшы

Баштапкы: Нью-Йорк же Сан-Франциско (эң чоң колдонуучу базасы)
Экинчи: Лондон же Франкфурт (Европа)
Үчүнчү: Сингапур же Токио (Азия аймагы)

Ишенимдүү кеңеш: Критикалык программаларды автоматтык түрдө бир нече жайга жайгаштыруу, максималдуу иштөө убактысын жана географиялык резервди камсыз кылуу.

Маалымат борборунун инфраструктурасы

Стандарттык өзгөчөлүктөр (бардык жайгашууларда)

✓ 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 сервериңизди башка жайга көчүрүп, сүрөттөрдү колдоно аласыз:

Бар болгон VPS'тин сүрөтүн жаратуу
Жаңы VPSти максаттуу жайгаштырууда жаратуу
Снимканы жаңы VPSке калыбына келтирүү
Жаңы IPге багыттоо үчүн DNS жазууларын жаңылоо
Миграция текшерилгенден кийин эски 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.

VPS.org API