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

مطابقت کی ضرورتوں سے

نیٹ ورک کارکردگی

اہم مارکیٹوں کے لئے کم سے کم Latency
  • شمال امريکه نيو يارک (2ms US مشرق), سان فرانسسکو (2ms US مغرب)
  • يورپ: فرینکفورٹ (3ms)، لندن (5ms)
  • ايشيا: سنگاپور (5ms)، ٹوکیو (8ms)
  • اوشينيا سڈني (کچھ آپشن)
عالمی تقسیم کے لئے بہترین
  1. پرائمری: نيو يارک يا سان فرانسسکو (بڑی ترین استعمال کرنے والے کی بنیاد)
  2. ثانوي: لندن يا فرانکفورت ( يورپ کا کوڈري)
  3. ترسيل: سنگاپور يا ٹوکيو (ايشيا کو برير)
ہدایت: مشن-جدید ایپلیکیشنوں کے لئے، ایک سے زیادہ جگہوں پر آپٹمائیز فائیلوور کے ساتھ پھیلاؤ حداکثر اپٹیم اور جغرافیائی اضافی کے لئے.

ڈیٹا سینٹر

معیاری خصوصیات (تمام مقامات)

  • ✓ ٹیئر III یا اعلیٰ ڈیٹا سینٹرز
  • ✓ 100% اپ ٹائم ایس ایل اے
  • ✓ اضافی توانائي (N+1 يا 2N)
  • ✓ اضافی کولنگ
  • ✓ 24/7 جسمانی حفاظت
  • ✓ بایومیٹرک رسائی کنٹرول
  • ✓ ڈی ڈوس حفاظت (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 کو مختلف جگہ پر سناپ شاٹ کے استعمال سے منتقل کر سکتے ہیں:

  1. اپنے موجود VPS کا ایک سناپ شاٹ بنائیں
  2. مقصدی مقام میں نیا VPS بنائیں
  3. نئے VPS میں سناپ شاٹ کو بحالی کریں
  4. DNS ریکارڈس کو نئے IP کی طرف اشارہ کرنے کے لیے اپڈیٹ کریں
  5. نقل و حمل کی تصدیق کے بعد پرانی VPS کو حذف کریں
یادداشت: ایک نئے مقام پر منتقلی سے ایک نیا IP پتہ پیدا ہوگا۔ DNS کے پھیلنے کے وقت کے لئے منصوبہ بندی کریں (عام طور پر پورے عالمی پھیلنے کے لئے 24-48 گھنٹے)۔

متعدد جگہوں پر استعمال

اعلیٰ دستیابی اور عالمی رسائی کے لئے، متعدد مقامات میں نشر پر غور کریں:

استعمال کے حالات
  • عالمی مواد کی فراہمی
  • جغرافیائی لوڈ توازن
  • آفت یابی
  • ڈیٹا ریسیڈنسی قوانین کے مطابق
  • بین الاقوامی استعمال کرنے والوں کے لئے کم کی گئی لیٹنسی
نفاذ
  • DNS پر مبنی لوڈ توازن (GeoDNS)
  • سی ڈی این انٹیگریشن (کلاؤڈ فلیئر، وغیرہ)
  • علاقوں میں ڈیٹا بیس ریپلیکشن
  • مشترکہ ذخیرہ حل
  • ایپلیکیشن سطحی فائل اورور
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.