API ea Libaka

FUMANA /api/v1/locations/

Thathamisa Libaka Tsohle

Fumana lethathamo la libaka tsohle tse fumanehang moo u ka sebelisang li-server tsa VPS.

Liparamitha tsa Potso

Parameter	Mofuta	E hlokahala	Bophara
`region`	string	Ha ho joalo	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	Ha ho joalo	Show only locations currently accepting new servers

Kopo ea Mohlala

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

Karabo ea Mohlala

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

Masimo a Karabo

Setereke	Mofuta	Bophara
`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

Likhoutu tsa Boemo ba Karabelo

200	Lethathamo la libaka le fumanoe ka katleho
401	Ha ea lumelloa - Tokeno ea netefatso e fosahetseng kapa e sieo

Choosing the Right Location

Ka Sehlooho

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

Ka litlhoko tsa ho latela

GDPR (EU Ts'ireletso ea Data): London, Frankfurt
Litaba tsa US: New York, San Francisco
Canada Data Sovereignty: Toronto
APAC Data Residency: Singapore, Tokyo, Sydney

Tšebetso ea marang-rang

Latency e tlase ho Limmaraka tse kholo

Amerika Boroa New York (2ms ho US East), San Francisco (2ms ho US West)
Europe: Frankfurt (3ms), London (5ms)
Asia: Singapore (5ms), Tokyo (8ms)
Oceania Sydney (khetho feela)

E loketseng ho fetisoa ka bophara

Bohlokoa: New York kapa San Francisco (base ea mosebelisi e kholo)
Sekoahelo: London kapa Frankfurt (ho koaloa ha Europe)
Tertiary: Singapore kapa Tokyo (Asia e koahelang)

Litlhahiso: Bakeng sa li-applications tsa mission-critical, kenya libaka tse ngata ka failover e potlakileng bakeng sa nako e phahameng ea ho sebetsa le ho fokotsa li-geographic.

Datacenter Infrastructure

Likarolo tse tloaelehileng (Libaka tsohle)

✓ Tier III kapa datacenters tse phahameng
✓ 100% uptime SLA
✓ Boholo ba matla a ho tlosoa (N+1 kapa 2N)
✓ Ho futhumatsa ho feletseng
✓ 24/7 polokeho ea'mele
✓ Litlhophiso tsa ho fihlella ka biometric

✓ DDoS ho sireletsa (ho fihlela ho 10 Tbps ho fokotsa)
✓ IPv4 le IPv6 tšehetso
✓ Networking ea botho (VLAN)
✓ 10 Gbps + backbone ea marang-rang
✓ Li-providers tse ngata tsa upstream
✓ BGP peering le linetweke tse kholo

Li-providers tsa marang-rang

_Tšireletso	Mofani	Lebelo	Litlhaku
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

Ho tsamaea lipakeng tsa libaka

U ka fetisetsa VPS ea hau sebakeng se fapaneng ka ho sebelisa snapshots:

E-na le VPS e teng
E_ba le VPS e ncha sebakeng sa ho qetela
Ntša snapshot ho VPS e ncha
Ho nchafatsa li-records tsa DNS ho bonts'a IP e ncha
Hlahloba ho fetisoa ha VPS e fetileng

Tlhaloso: Ho fetisetsa sebakeng se secha ho tla baka lengolo-tsoibila le lecha la IP. Sebelisa nako ea ho fetisetsa DNS (ka linako tse ling lihora tse 24-48 bakeng sa ho fetisetsa ka bophara).

Ho kenya libakeng tse ngata

Bakeng sa ho fumaneha le ho fihla ka bophara, nahana ka ho kenya libakeng tse ngata:

Litšoantšo

Ho fana ka litaba ka bophara
Ho bapisa ho tjhaja ka li-geo
Ho khutlisa ka mor'a ho senyeha
Ho latela melao ea ho lula ha data
Latency e fokotsehileng bakeng sa basebelisi ba machaba

Ho kenya

Ho bapisa boima bo nang le DNS (GeoDNS)
Ho hokahanya CDN (Cloudflare, jj.)
Replication database lipakeng linaha
Litharollo tsa polokelo e tšehelitsoeng
Failover ea boemo ba sephutheloana

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

VPS.org API