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 Նյու Յորք (2մս դեպի ԱՄՆ արևելք), Սան Ֆրանցիսկո (2մս դեպի ԱՄՆ արևելք)
  • Եվրոպա: Ֆրանկֆուրտ (3մս), Լոնդոն (5մս)
  • Ասիական Սինգապուր (5մս), Տոկիո (8մս)
  • ՕկեանիաName Սիդնեյ (միայն ընտրություն)
Գլոբալ վաճառքի համար լավագույնը
  1. Հիմնական: Նյու Յորք կամ Սան Ֆրանցիսկո (օգտագործողների ամենամեծ բազա)
  2. Երկրորդական: Լոնդոն կամ Ֆրանկֆուրտ (Եվրոպայի շրջանակներում)
  3. Երկրորդական Սինգապուր կամ Տոկիո (Ասիական տարածաշրջան)
Խորհուրդ Միջոցառումների համար կարևոր ծրագրերի համար, տեղադրեք մի քանի վայրերում ավտոմատ կերպով, որպեսզի ապահովեք առավելագույն ժամանակը և երկրագրական ավելորդությունը։

Տվյալների կենտրոնի ինֆրակառուցվածք

Ստեղծող

  • ✓ III կամ ավելի բարձր մակարդակ
  • ✓ 100% uptime SLA
  • ✓ Չափազանց մեծ էներգիա (N+1 կամ 2N)
  • ✓ Չափազանց շատ սառեցում
  • ✓ 24/7 ֆիզիկական անվտանգություն
  • ✓ Բիոմետրիկ մուտքային կառավարում
  • ✓ DDoS պաշտպանություն (մինչև 10 Tbps նվազեցում)
  • ✓ IPv4 և IPv6 աջակցություն
  • ✓ Համակարգչային ցանց
  • ✓ 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.