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

דורך װײַטער־צופֿרידנקייט־װירוס

נעץ־פּראָפֿעסיאָנאַליטעט

קלענסטע לײטערײט צו גרעסערע מארקעטן
  • צפון אמעריקא New York (2 מיסלען צו אױס־אַמעריקע), San Francisco (2 מיסלען צו אױס־אַמעריקע מערב)
  • װאָרענונג: פֿראַנקפֿאַרץ (3 מיס), לאָנדאָן (5 מיס)
  • אסי סינדערעלאַ (5 מיס), טוקיאָ (8 מיס)
  • אוקעאַניע סידני (אױפֿציע)
בלױז פֿאַר אױסגעװײנטלעכע פֿאַרװאַנדלונג
  1. װײַטער New York אָדער San Francisco (גרעסטע ניצער־באזירטע)
  2. צווייטער: לאָנדאָנע אָדער פֿראַנקפֿאָרט (אייראָפּע דעקאַפּירונג)
  3. דריטע: סינדערעלאַ אָדער טוקיאָ (אַזיע דעקאַפּירונג)
הילף פֿאַר מיסיע-קריטיש אַפּליקאַציעס, אַרײַנשטעלן צו מערערע אָרטן מיט אויטאָמאַטיש פֿאַלאָלופּ פֿאַר מאַקסימום אַרבעטצײַט און געאָגראַפֿישע רידוסטאַנס.

דאַטן־צענטער־אינפֿאָרמאַציע

סטנדרטישע פֿעיִקייטן (אַלע אָרטן)

  • ✓ Tier 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. סעלעקציע:
  3. איבער־פֿאַרקער דעם בילדל צום נײַעם VPS
  4. דערהייַנטיקן DNS אױספֿאָרעם צו װײַזן צו דער נײַער IP
  5. מעק אַרױס
נאָטיצן: אױב איר װײַזט צו אַ נײַעם אָרט, װעט דאָס װײַזן אַ נײַעם 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.