API tal-Lokazzjonijiet

IKSEB /api/v1/locations/

Elenka l-Lokazzjonijiet Kollha

Iġbor lista tal-postijiet kollha disponibbli taċ-ċentru tad-data fejn tista' tuża servers VPS.

Parametri tal-Mistoqsija

Parametru	Tip	Meħtieġ	Deskrizzjoni
`region`	string	Nru	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	Nru	Show only locations currently accepting new servers

Eżempju ta' Talba

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

Eżempju ta' Rispons

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

Oqsma ta' Rispons

Qasam	Tip	Deskrizzjoni
`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

Kodiċijiet tal-Istatus tar-Rispons

200	Lista ta' postijiet irkuprata b'suċċess
401	Mhux Awtorizzat - Token ta' awtentikazzjoni mhux validu jew nieqes

Choosing the Right Location

Mill-udjenza fil-mira

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

Skont ir-Rekwiżiti ta’ Konformità

GDPR (Protezzjoni tad-Dejta tal-UE): London, Frankfurt
Residenza tad-Dejta tal-Istati Uniti: New York, San Francisco
Sovranità tad-Dejta Kanadiża: Toronto
APAC Data Residenza: Singapore, Tokyo, Sydney

Prestazzjoni tan-Netwerk

Latenza l-Irħas għas-Swieq Maġġuri

L-Amerika ta’ Fuq: New York (2ms għall-Lvant tal-Istati Uniti), San Francisco (2ms għall-Punent tal-Istati Uniti)
L-Ewropa: Frankfurt (3ms), Londra (5ms)
L-Asja: Singapor (5ms), Tokjo (8ms)
L-Oċeanja: Sydney (għażla biss)

Aħjar għad-Distribuzzjoni Globali

Primarja: New York jew San Francisco (l-akbar bażi tal-utent)
Sekondarji: Londra jew Frankfurt (kopertura tal-Ewropa)
Terzjarju: Singapor jew Tokyo (kopertura tal-Asja)

Għall- Tip: Għall-applikazzjonijiet missjoni-kritiċi, jimplimentaw għal postijiet multipli mal-failover awtomatiku għall-uptime massimu u ġeografika żejda.

Infrastruttura taċ-Ċentru tad-Data

Karatteristiċi Standard (Postijiet kollha)

✓ Livell III jew ċentri tad-dejta ogħla
✓ 100% uptime SLA
✓ Qawwa żejda (N+1 jew 2N)
✓ Tkessiħ żejjed
✓ Sigurtà fiżika 24/7
✓ Kontrolli tal-aċċess bijometriku

✓ Protezzjoni DDoS (sa 10 Tbps mitigazzjoni)
✓ Appoġġ IPv4 u IPv6
✓ Netwerking privat (VLAN)
✓ 10 Gbps + netwerk backbone
✓ Fornituri multipli upstream
✓ BGP peering ma' netwerks maġġuri

Fornituri tan-Netwerk

Post	Fornitur	Annimali	Noti
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

Jiċċaqilqu Bejn Postijiet

Tista' timmigra l-VPS tiegħek għal post differenti billi tuża snapshots:

Oħloq snapshot tal-VPS eżistenti tiegħek
Oħloq VPS ġdid fil-post fil-mira
Ir-restawr tal-istampa snapshot għall-VPS ġdid
Aġġorna r-rekords DNS biex tipponta lejn IP ġdid
Ħassar il-VPS il-qadim ladarba l-migrazzjoni tkun ivverifikata

Nota: Il-migrazzjoni għal post ġdid tirriżulta f'indirizz IP ġdid.Pjan għall-ħin tal-propagazzjoni tad-DNS (tipikament 24-48 siegħa għal propagazzjoni globali sħiħa).

Implimentazzjoni f’Diversi Postijiet

Għall-disponibbiltà għolja u l-firxa globali, jikkunsidraw l-iskjerament f'postijiet multipli:

Każijiet ta’ użu

Twassil ta' kontenut globali
Ibbilanċjar tat-tagħbija ġeografika
Irkupru minn diżastri
Konformità mal-liġijiet tar-residenza tad-dejta
Latenza mnaqqsa għall-utenti internazzjonali

Implimentazzjoni

Ibbilanċjar tat-tagħbija bbażat fuq id-DNS (GeoDNS)
Integrazzjoni CDN (Cloudflare, eċċ.)
Replikazzjoni tad-database bejn ir-reġjuni
Soluzzjonijiet ta' ħażna kondiviżi
Failover fil-livell tal-applikazzjoni

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

VPS.org API