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

შესაბამისობის მოთხოვნებით

ქსელის სიჩქარეName

მცირე ლოდინი ძირითადი ბაზრების მიმართ
  • ჩრდილოეთ ამერიკაusa. kgm ნიუ იორკი (აშშ- ს აღმოსავლეთიდან 2 მსთ), სან ფრანცისკოს (აშშ- ს დასავლეთიდან 2 მსთ)
  • ევროპა: ფრანკფურტი (3ms), ლონდონი (5ms)
  • აზია: სინგაპური (5ms), ტოკიო (8ms)
  • ოკეანე: ჟიდენი (მხოლოდ პარამეტრები)
გლობალური გადმოცემისთვის საუკეთესო
  1. ძირითადი: ნიუ იორკ ან სან ფრანცისკოს (უდიდესი მომხმარებლის ბაზა)
  2. მეორეული: ლონდონი ან ფრანკფურტი (ევროპის დაფარვა)
  3. მესამე: სინგაპური ან ტოკიო (აზია)
რჩევა: მნიშვნელოვანი პროგრამებისთვის, ავტომატური გადართვით, მაქსიმალური დროის განმავლობაში მუშაობისა და გეოგრაფიული რედენდუნის შესაძლებლობისთვის, მრავალ ადგილას განთავსება.

მონაცემთა ცენტრის ინფრასტრუქტურა

სტანდარტული ფუნქციები (ყველა მდებარეობა)

  • ✓ III და უფრო მაღალი დონის მონაცემთა ცენტრები
  • ✓ 100% SLA
  • ✓ ენერგიის გადაჭარბება (N+1 ან 2N)
  • ✓ აკჲ ჟვ ჲჟრაგთ ჟჲ ჳლაენვ,
  • ✓ 24/7 ტთჱთფნა ჲჳპანა
  • ✓ ბიომეტრიული წვდომის კონტროლი
  • ✓ DDoS დაცვა (10 Tbps- მდე)
  • ✓ IPv4 და IPv6 მხარდაჭერა
  • ✓ პირადი ქსელი (VLAN) Name
  • ✓ 10 Gbps+ ქსელის ბაზალური ქსელი
  • ✓ მრავალჯერადი ზედა ქსელის პროვაიდერები
  • ✓ BGP- ს კავშირი ძირითად ქსელებთან

ქსელის პროვაიდერებიName

ადგილმდებარეობა მიმწოდებელი იანვარი ჩანაწერები
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. ატვირთვის აღდგენა
  4. DNS ჩანაწერების განახლება ახალი IP მისამართის დასახელებისთვის
  5. ძველი VPS- ის წაშლა მიგრაციის დადასტურების შემდეგ
შენიშვნა: ახალი ადგილმდებარეობის მიგრაცია გამოიწვევს ახალი IP მისამართის მიღებას. DNS- ის გავრცელების დროის დაგეგმვა (ჩვეულებრივ 24- 48 საათი სრული გლობალური გავრცელებისთვის).

მრავალ- ლოკაციის განთავსება

მაღალი ხელმისაწვდომობისა და გლობალური მისაწვდომობისთვის, გაითვალისწინეთ მრავალ ადგილას განთავსება:

გამოყენების შემთხვევები
  • გლობალური შინაარსის მიწოდება
  • გეოგრაფიული დატვირთვის ბალანსირება
  • აღდგენა
  • ჟჲჲბჲპსგაŒვ ჟჲ ჱაკჲნთრვ ჱა ოპვბსგაŒვ ნა ეანჲგთრვ
  • შემცირებული ლოდინი საერთაშორისო მომხმარებლებისთვის
განხორციელება
  • DNS-ზე დაფუძნებული დატვირთვის ბალანსირება (GeoDNS)
  • CDN ინტეგრაცია (Cloudflare და ა.შ.)
  • მონაცემთა ბაზის რეპლიკაცია რეგიონებს შორის
  • ქსელის პარამეტრებიName
  • პროგრამის დონის გადართვა
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.