VPS.org API

REST API belgelendirmesi

Konumlar API'si

Retrieve information about available datacenter locations for VPS deployment.

Uç noktalar 1 endpoint
Temel Yol /api/v1/locations
ELDE ETMEK /api/v1/locations/

Tüm Konumları Listele

VPS sunucularını dağıtacağınız tüm mevcut veri merkezi konumlarının bir listesini al.

Sorgu Parametreleri

Parametreler Tip Gerekli Açıklama
region string Hayır. Filter by region: north-america, europe, asia, oceania
available boolean Hayır. Show only locations currently accepting new servers

Örnek Talep

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

Örnek Yanıt

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

Yanıt Alanları

Alan Tip Açıklama
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

Yanıt Durum Kodları

200 Konum listesi başarıyla alındı.
401 Yetkisiz - Geçersiz veya eksik kimlik doğrulama belirteci

Choosing the Right Location

Hedef kitle

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

Uyumluluk Şartları

Ağ Performansı

Ana Pazarlara En Düşük Gecikme
  • Kuzey Amerika: New York (2ms ABD Doğusuna), San Francisco (2ms ABD Batısına)
  • Avrupa: Frankfurt (3ms), Londra (5ms)
  • Asya: Singapur (5ms), Tokyo (8ms)
  • Okyanusya: Sydney (tek seçenek)
Küresel Dağıtım için En İyi
  1. Ana: New York veya San Francisco (en büyük kullanıcı taban)
  2. İkinci: Londra veya Frankfurt (Avrupa haberi)
  3. Üçüncül: Singapur veya Tokyo (Asya'yı kapsar)
İpucu: Görevsel kritik uygulamalar için, maksimum çalışma süresi ve coğrafi yetersizlik için otomatik hata ayıklama ile birden fazla yere dağıtın.

Veri Merkezi Altyapısı

Standart Özellikler (Tüm Yerler)

  • ✓ Tier III veya daha yüksek veri merkezleri
  • ✓ %100 çalışma süresi SLA
  • ✓ Gereksiz güç (N+1 veya 2N)
  • ✓ Gereksiz soğutma
  • ✓ 24/7 fiziksel güvenlik
  • ✓ Biometrik erişim kontrolleri
  • ✓ DDoS koruması (10 Tbps'ye kadar azaltma)
  • ✓ IPv4 ve IPv6 desteği
  • ✓ Özel ağ (VLAN)
  • ✓ 10 Gbps+ ağ omurgası
  • ✓ Çok sayıda üst düzey sağlayıcı
  • ✓ BGP büyük ağlarla eşleştirme

Ağ Sağlayıcıları

Konum Sağlayıcı Hayvan Notlar
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

Konumlar Arasında Geçmek

VPS' nizi fotoğraflar kullanarak farklı bir yere taşıyabilirsiniz:

  1. Mevcut VPS'nizin bir görüntüsünü oluşturun
  2. Hedef konumda yeni bir VPS oluştur
  3. Yeni VPS'ye snapshot'u geri getir
  4. Yeni IP'ye işaret etmek için DNS kayıtlarını güncelle
  5. Göç doğrulandıktan sonra eski VPS'yi sil
Not: Yeni bir yere taşınmak yeni bir IP adresi ile sonuçlanacaktır. DNS yayılma süresini planlayın (genellikle tam küresel yayılma için 24-48 saat).

Çok Konumlu Kullanım

Yüksek ulaşılabilirlik ve küresel ulaşılabilirlik için, birden fazla yerde dağıtmayı düşünün:

Kullanım Durumları
  • Küresel içerik dağıtımı
  • Coğrafi yük dengeleme
  • Afet kurtarma
  • Veri yerleşim yasalarına uyum
  • Uluslararası kullanıcılar için gecikme azaltıldı
Uygulama
  • DNS tabanlı yük dengeleme (GeoDNS)
  • CDN entegrasyonu (Cloudflare, vb.)
  • Bölgeler arasında veritabanı kopyalaması
  • Paylaşılmış depolama çözümleri
  • Uygulama seviyesi failover
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.