Goobaha API

HEL /api/v1/locations/

Liiska Dhammaan Goobaha

Soo celinta liiska dhammaan goobaha datacenter ee jira oo aad ku isticmaali karto VPS servers.

Cabbirrada Weydiinta

_Barnaamijyada	Nooca	Loo baahan yahay	Tilmaamaha
`region`	string	Ha	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	Ha	Show only locations currently accepting new servers

Codsi Tusaale ah

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

Jawaabta Tusaale

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

Goobaha Jawaabta

Isku-darka	Nooca	Tilmaamaha
`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

Koodhadhka Xaaladda Jawaab celinta

200	Liiska goobaha si guul leh ayaa loo soo ceshaday
401	Aan la ogolayn - Calaamadda xaqiijinta oo aan sax ahayn ama maqan

Choosing the Right Location

By Target Audience

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

By shuruudaha waafaqsan

GDPR (Ilaaliyaha xogta EU): London, Frankfurt
US Data Deganaanshaha: New York, San Francisco
Xogta Qaranka Kanada: Toronto
APAC xogta deggenaansho: Singapore, Tokyo, Sydney

Shaqada Shabakadda

Latency ugu yar ee suuqyada waaweyn

Waqooyiga Ameerika New York (2ms in US East), San Francisco (2ms in US West)
Yurub: Frankfurt (3ms), London (5ms)
Aasiya: Singapore (5ms), Tokyo (8ms)
Oceania: Sydney (doorasho kaliya)

Ugu Fiican ee Global Distribution

Awooda ugu weyn: New York ama San Francisco (xarunta isticmaalaha ugu weyn)
Labaad: London ama Frankfurt (Europe daboolida)
Daraasadda koowaad: Singapore ama Tokyo (Asia daboolida)

Tallaabo: Si loo helo codsiyada muhiimka ah ee muhiimka ah, u isticmaasho meelo badan oo leh fayl-ka-soo-celinta otomaatiga ah ee ugu badan ee ugu badan iyo xaddidan.

Datacenter dhismaha

Features Standard (Meelo Dhammaan)

✓ Tier III ama xarumaha xogta sare
✓ 100% uptime SLA
✓ awoodda dheeraadka ah (N + 1 ama 2N)
✓ Baakadaha
✓ 24/7 amniga jirka
✓ Biometric xakamaynta helitaanka

✓ DDoS ilaalinta (ugu badnaan 10 Tbps yareynta)
✓ IPv4 iyo IPv6 taageero
✓ Shabakad gaar ah (VLAN)
✓ 10 Gbps + xarigga xarigga
✓ Qaar ka mid ah upstream bixiyaha
✓ BGP peering la networks waaweyn

Xidhiidhka

_Meel	Bixiye	Qiyaamaha	Faahfaahin
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

Guji goobaha dhexdooda

Waxaad u wareejin kartaa VPS aad meel kale oo isticmaalaya snapshots:

Abuur sawir ka mid ah VPS-gaaga hadda jira
abuuro VPS cusub ee goobta la doonayo
Soo celin sawirka VPS cusub
Update diiwaanada DNS si ay u muujiyaan in IP cusub
tirtirta VPS hore marka la xaqiijiyo is-dhexgalka

Faahfaahin: U dhaqaaqa meel cusub waxay keeni doontaa cinwaan IP cusub. Qorshaha waqtiga faafinta DNS (sida caadiga ah 24-48 saacadood oo ah faafinta adduunka oo dhan).

Dhismaha Goobaha Badan

Si aad u hesho awood sare iyo gaadhista adduunka, ka fikir isticmaalka meelaha badan:

Waxyaabaha la isticmaalo

Soo bandhigidda waxyaabaha adduunka
Miisaanka culeyska geografik
Soo kabashada
U hoggaansanaanta sharciga deggenaanshaha xogta
Latency yar ee dadka isticmaala caalamiga ah

Dhammaan

Isku dheelitirka culayska ku saleysan DNS (GeoDNS)
Isku xirka CDN (Cloudflare, iwm.)
Database duubista gobollada oo dhan
Xalka kaydinta wadaaga
Ka-hortagga heerka barnaamijyada

Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.

VPS.org API