VPS.org API

REST API بەڵگەنامە

API-ya cihan

Retrieve information about available datacenter locations for VPS deployment.

Xalên Dawî 1 endpoint
Riya bingehîn /api/v1/locations
STENDIN /api/v1/locations/

Hemû Cihên Lîsteyê Bike

لیستێک لە شوێنە دراوەکان بەدەست بهێنە کە دەتوانیت سەرپەرشتیاری VPS دابمەزرێنیت.

Parametreyên Lêpirsînê

پارامەتر Awa Pêwîst باسکردن
region string نەخێر Filter by region: north-america, europe, asia, oceania
available boolean نەخێر Show only locations currently accepting new servers

Daxwaza Nimûne

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);

Bersiva Mînakî

{
  "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
      }
    }
  ]
}

Zeviyên Bersivê

بەشی ناوەوەی پەڕەکە Awa باسکردن
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

Kodên Rewşa Bersivê

200 Lîsteya cihan bi serkeftî hate wergirtin
401 Bêdestûr - Nîşana pejirandinê ya nederbasdar an jî winda

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

بە پێی پێداویستیەکانی ڕێککەوتن

کارایی شەبکە

کەمترین دواکەوتن بۆ بازاڕەکانی سەرەکی
  • ئەمریکای باشوور نیویۆرک (2ms بۆ ڕۆژھەڵاتی ئەمریکا)، سان فرانسیسکۆ (2ms بۆ ڕۆژئاوای ئەمریکا)
  • ئەوروپا: فرانکفۆرت (3ms)، لەندەن (5ms)
  • ئاسیا: سنهگال (٥ ملیسێک)
  • ئوقیانیا سیدینیا (تەنها هەڵبژاردەکە)
باشترین بۆ دابەشکردنی جیهانی
  1. سەرەکی: نیویۆرک یان سان فرانسیسکۆ (بەکارھێنەری گەورە)
  2. دووەم: لەندەن یان فرانکفۆرت (ئەورووپا)
  3. سێیەم: سنهگال یان توکیو (ئەفریقا)
ئامۆژگاری: بۆ کاری گرنگی کاریگەر، دابەشکردنی بۆ شوێنە جۆراوجۆرەکان بە خۆڕایی بۆ کاتی بەرزترین و جوگرافیا زیادە.

بنەڕەتی ناوەندی زانیاری

تایبەتمەندی ستاندارد (هه‌ر شوێنێک)

  • ✓ ناوەندی زانیاریی پلەی سێ یان زیاتر
  • ✓ %100 کاتی کارکردن
  • ✓ هێزی زیادە (N+1 یان 2N)
  • ✓ ‌هەناسەدان
  • ✓ 24/7 ئاسایشی فیزیکی
  • ✓ کۆنتڕۆڵی گەیشتنی بایۆمێتریک
  • ✓ پاراستنی DDoS (تا ١٠ Tbps کەمکردنەوە)
  • ✓ پشتگیری IPv4 و IPv6
  • ✓ شەبکە تایبەتەکان
  • ✓ ١٠ گێگابیت
  • ✓ پێشکەشکەرانی زۆر
  • ✓ 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

گواستنەوەی نێوان شوێنەکان

دەتوانیت ڤێ پزیشکەکەت بگوازەوە بۆ شوێنێکی تر بە بەکارهێنانی وێنەکان:

  1. وێنەیەکی ڤێڵپ سرویسەکەت دروست بکە
  2. دروستکردنی VPS نوێ لە شوێنی ئامانج
  3. گەڕانەوەی وێنەی ڤیدیۆیی بۆ VPS نوێ
  4. نوێکردنەوەی تۆمارەکانی DNS بۆ نیشاندانی IPی نوێ
  5. دوای ئەوەی گواستنەوەی گەڕانەکە پشتڕاست کرایەوە، ڤێ پزیشکەکەی کۆن هەڵبگرە
ئامۆژگاری: گواستنەوەی بۆ شوێنێکی نوێ ئەنجامی ناوەوەی IPی نوێ دەبێت. پلان بۆ کاتی بڵاوبوونەوەی DNS دابنێ (بە شێوەیەکی گشتی ٢٤-٤٨ کاتژمێر بۆ بڵاوبوونەوەی جیهانی تەواو).

ڕەوانەکردنی شوێنی زۆر

بۆ گەیشتنێکی بەرز و جیهانی، بیر لە دابەشکردنی لە شوێنە زۆرەکاندا بکە:

بەکارھێنانی حاڵەتەکان
  • ڕەوانەیکردنی ناوەڕۆکەکانی جیهان
  • هاوسەنگیکردنی کێشی جوگرافی
  • گەڕانەوەی کارەسات
  • پەڕەی زانیاری
  • کەمکردنەوەی کاتی چاوەڕێکردن بۆ بەکارهێنەرانی نێودەوڵەتی
جێبەجێکردن
  • هاوسەنگیکردنی بارکردن لەسەر بنەمای DNS (GeoDNS)
  • CDN بەستنەوەی (Cloudflare, etc.)
  • دووبارەکردنەوەی بنکەی زانیاری لە نێوان ناوچەکاندا
  • چارەسەری پارێزەری هاوبەش
  • وازهێنان لە ئاستی بەرنامەکە
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.