API-ja e Vendndodhjeve

MERR /api/v1/locations/

Listo të gjitha vendndodhjet

Merr një listë të të gjitha vendeve të disponueshme të qendrave të të dhënave ku mund të vendosësh serverët VPS.

Parametrat e pyetjes

Parametrat	Lloji	E detyrueshme	Përshkrimi
`region`	string	Jo.	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	Jo.	Show only locations currently accepting new servers

Shembull Kërkese

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

Shembull Përgjigjeje

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

Fushat e Përgjigjes

Fusha	Lloji	Përshkrimi
`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

Kodet e Statusit të Përgjigjes

200	Lista e vendndodhjeve u mor me sukses
401	I paautorizuar - Token vërtetimi i pavlefshëm ose mungon

Choosing the Right Location

Sipas audiencës së synuar

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

Sipas kërkesave të përputhshmërisë

GDPR (Mbrojtja e të dhënave të BE-së): London, Frankfurt
Vendbanimi i të dhënave të SHBA: New York, San Francisco
Suvereniteti i të dhënave kanadeze: Toronto
Vendndodhja e të dhënave APAC: Singapore, Tokyo, Sydney

Performanca e rrjetit

Latency më të ulët për tregjet kryesore

Amerikë Veriore: New York (2ms në SHBA Lindje), San Francisco (2ms në SHBA Perëndim)
Europa: Frankfurt (3ms), Londër (5ms)
Azia: Singapori (5ms), Tokio (8ms)
Oqeani: Sydney (vetëm opsion)

Më i miri për shpërndarjen globale

Primare: New York ose San Francisco (baza më e madhe e përdoruesve)
Sekondare: Londër ose Frankfurt (përmbledhje e Evropës)
Terciar: Singapori ose Tokio (Mbështetja e Azisë)

Këshillë: Për aplikimet e misionit kritik, vendosjen në vende të shumta me automatike failover për kohën e punës maksimale dhe gjeografike redundancë.

Infrastruktura e Qendrës së Të Dhënave

Funksionet standarde (të gjitha pozicionet)

✓ Niveli III ose më i lartë
✓ 100% SLA
✓ Fuqia e tepërt (N+1 ose 2N)
✓ Ftohtë
✓ Siguria fizike 24/7
✓ Kontrolle hyrjeje biometrike

✓ Mbrojtje DDoS (deri në 10 Tbps mitigacion)
✓ Suporti IPv4 dhe IPv6
✓ Rrjeti privat (VLAN)
✓ 10 Gbps+ rrjet backbone
✓ Shumë furnizues
✓ BGP peering me rrjetet kryesore

Provider rrjeti

Vendndodhja	Provider	Animal	Shënim
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

Lëvizja midis pozicioneve

Mund të migroni VPS në një vend tjetër duke përdorur imazhet:

Krijo një foto të VPS ekzistues
Krijo një VPS të ri në pozicionin e synuar
Rivendos imazhin tek VPS i ri
Përditëso rregjistrimet DNS për të treguar IP të re
Elemino VPS e vjetër sapo të verifikohet migrimi

Shënim: Migrimi në një vendndodhje të re do të rezultojë në një adresë të re IP. Planifiko kohën e përhapjes së DNS (zakonisht 24-48 orë për përhapje të plotë globale).

Shpërndarje në shumë vende

Për disponueshmëri të lartë dhe përhapje globale, konsideroni vendosjen në vende të shumta:

Përdorimi

Përmbajtja globale
Balansimi gjeografik i ngarkesave
Rimëkëmbja nga katastrofa
Përputhje me ligjet e qëndrimit të të dhënave
Ulët vonesë për përdoruesit ndërkombëtare

Zbatimi

Balansimi i ngarkesave i bazuar në DNS (GeoDNS)
Integrimi CDN (Cloudflare, etj.)
Replika e database në rajone
Zgjidhje të përbashkëta të ruajtjes
Failover në nivel aplikimi

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

VPS.org API