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

مطابقت جي ضرورتن سان

نيٽ ورڪ ڪارڪردگي

وڏين مارڪيٽن لاءِ گهٽ ۾ گهٽ لاٽنسي
  • اتر آمريڪا نيو يارڪ (2ms US مشرق), سان فرانسسکو (2ms US مغرب)
  • يورپ: فرانڪفورٽ (3ms)، لنڊن (5ms)
  • ايشيا: سنگاپور (5ms)، ٽوڪيو (8ms)
  • اوشيانيا: سيدني (فقط اختيار)
عالمي ورڇ لاءِ بهترين
  1. پرائمري: نيو يارڪ يا سان فرانسسکو (وڏي استعمال ڪندڙن جو بنياد)
  2. ثانوي: لنڊن يا فرانڪفورٽ ( يورپ جي ڪنڊ ڪڙڇ)
  3. ٽيئريري: سنگاپور يا ٽوڪيو (آسيا جي ڪَپائي)
تجويز: مشن-جديد ايپليڪيشنن لاء، وڌ کان وڌ اپٽائم ۽ جغرافیائي اضافي جي لاءِ خودڪار failover سان ڪيترن ئي هنڌن تي استعمال ڪريو.

ڊيٽا سينٽر

معياري خاصيتون (سڀيون جڳھون)

  • ✓ ٽيئر III يا مٿي ڊيٽا سينٽر
  • ✓ 100% اپٽائم SLA
  • ✓ اضافي طاقت (N+1 يا 2N)
  • ✓ اضافي ٿڌائي
  • ✓ 24/7 جسماني حفاظت
  • ✓ بايو ميٽرڪ رسائي ڪنٽرول
  • ✓ DDoS حفاظت (10 Tbps تائين)
  • ✓ 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)
  • CDN انٽيگريشن (Cloudflare، وغيره)
  • علائقن ۾ ڊاٽ بيس نقل
  • ونڊوز
  • ايپليڪيشن جي سطح تي فائل لوڊ
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.