VPS.org API

REST API sənədləşdirilməsi

Yerləşmə API-si

Retrieve information about available datacenter locations for VPS deployment.

Son Nöqtələr 1 endpoint
Əsas Yol /api/v1/locations
AL /api/v1/locations/

Bütün Yerləri Siyahıya Alın

VPS serverləri quraşdıra biləcəyiniz bütün mövcud məlumat mərkəzi yerlərinin siyahısını əldə edin.

Sorğu Parametrləri

Parametrlər Növü Tələb olunur İzahat
region string _Yox Filter by region: north-america, europe, asia, oceania
available boolean _Yox Show only locations currently accepting new servers

Nümunə Sorğu

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

Nümunə Cavab

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

Cavab Sahələri

Sahə Növü İzahat
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

Cavab Status Kodları

200 Məkan siyahısı uğurla əldə edildi
401 İcazəsiz - Yanlış və ya çatışmayan identifikasiya nişanı

Choosing the Right Location

Məqsəd

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

Təkliflər

Şəbəkə performansı

Əsas bazarlara ən aşağı gecikmə
  • Şimali Amerika: New York (2ms US East), San Francisco (2ms US West)
  • Avropa: Frankfurt (3ms), London (5ms)
  • Asiya: Singapur (5ms), Tokio (8ms)
  • Okeaniya Sidney (yalnız seçim)
Qlobal paylama üçün ən yaxşısı
  1. Əsas: New York və ya San Francisco (ən böyük istifadəçi bazası)
  2. İkinci: London və ya Frankfurt (Avropa əhatə)
  3. Üçüncülü: Singapur və ya Tokio (Asiya əhatə dairəsi)
İpucu: Misyon-kritik tətbiqlər üçün, maksimum uptime və coğrafi redundansiya üçün avtomatik failover ilə bir çox yerlərə işə salın.

Data Mərkəzi

Standart xüsusiyyət (bütün yerlər)

  • ✓ Tier III və ya daha yüksək məlumat mərkəzləri
  • ✓ 100% iş vaxtı SLA
  • ✓ Üstündən güc (N+1 və ya 2N)
  • ✓ Sür'ətli soyutma
  • ✓ 24/7 fiziki təhlükəsizlik
  • ✓ Biometrik çıxış nəzarəti
  • ✓ DDoS qorunması (10 Tbps-ə qədər azalma)
  • ✓ IPv4 və IPv6 dəstək
  • ✓ Özəl şəbəkələr (VLAN)
  • ✓ 10 Gbps+ şəbəkənin arxası
  • ✓ Birdən çox yüksəl təminatçı
  • ✓ BGP peering with major networks

Şəbəkə Xidmət Vericiləri

Yer Provayder Tərcümə Xatırlatmalar
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

Yerlər arasında hərəkət

VPS-nizin şəkillərini istifadə edərək başqa bir yerə köçürə bilərsiniz:

  1. Hazırkı VPS-nizin bir görüntüsünü yaradın
  2. Məqsəd yerdə yeni VPS yarat
  3. Yeni VPS-ə şəkli bərpa et
  4. Yeni IP-yə işarə etmək üçün DNS qeydlərini yeniləyin
  5. Göçü təsdiqləndikdən sonra köhnə VPS-i sil
Xatırlatma: Yeni yerə köçürmə yeni IP ünvanına səbəb olacaq. DNS yayılma vaxtını planlaşdırın (ümumi yayılma üçün 24-48 saat).

Birdən çox yer

Yüksək mövcudluq və qlobal təsir üçün, bir çox yerlərdə işə salmağı düşünün:

İstifadə halları
  • Qlobal məzmun çatdırılması
  • Coğrafi yük balansı
  • Fayl bərpası
  • Data yaşayış qanunlarına uyğunluq
  • Beynəlxalq istifadəçilər üçün azaldılmış gecikmə
İcra
  • DNS-ə əsaslanan yük balansı (GeoDNS)
  • CDN inteqrasiyası (Cloudflare, və s.)
  • Data bazasının bölgələr arasında təkrarlanması
  • Bölüşdürülən saxlama həllləri
  • Proqram səviyyəli failover
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.