API de localizacións

OBTER /api/v1/locations/

Listar todas as localizacións

Obtén unha lista de todos os lugares dispoñíbeis do centro de datos onde pode implantar servidores VPS.

Parámetros de consulta

Parámetros	Tipo	Obrigatorio	Descrición
`region`	string	Non	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	Non	Show only locations currently accepting new servers

Exemplo de solicitude

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

Exemplo de resposta

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

Campos de resposta

Campo	Tipo	Descrición
`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

Códigos de estado de resposta

200	Lista de localizacións recuperada correctamente
401	Non autorizado: token de autenticación non válido ou falta

Choosing the Right Location

Segundo o público obxectivo

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

Segundo os requisitos de conformidade

Protección de datos London, Frankfurt
Datos de residencia nos EUA: New York, San Francisco
Soberanía de datos canadense: Toronto
Residência de datos APAC: Singapore, Tokyo, Sydney

Desempeño da redeName

A latencia máis baixa para os principais mercados

América do Norte: Nova York (2ms ao leste dos EUA), San Francisco (2ms ao oeste dos EUA)
Europa: Frankfurt (3ms), Londres (5ms)
Asia: Singapur (5ms), Toquio (8ms)
Oceanía: Sydney (só opción)

Mellor para a distribución global

Primaria: Nova York ou San Francisco (a base de usuarios máis grande)
Secundaria: Londres ou Frankfurt (cobertura de Europa)
Terciario: Singapur ou Tokio (cobertura de Asia)

Consello: Para aplicacións críticas, despliegue en múltiples localizacións con failover automático para un tempo de actividade máximo e redundancia xeográfica.

Infraestrutura do centro de datos

Funcionalidades estándar (Todas as localizacións)

✓ Datacenters de nivel III ou superior
✓ SLA de 100% de tempo de actividade
✓ Potencia redundante (N+1 ou 2N)
✓ Refrigeración redundante
✓ Seguridade física 24/7
✓ Controles de acceso biométricos

✓ Protección contra ataques DDoS (ata 10 Tbps de mitigación)
✓ Soporte para IPv4 e IPv6
✓ Rede privada (VLAN)
✓ Rede de 10 Gbps+ backbone
✓ Múltiples provedores ascendentes
✓ Emparellamento BGP con redes principais

Provedores de rede

Localización	Provedor	Tier	Notas
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

Moverse entre os lugares

Pode migrar o seu VPS a un lugar diferente empregando instantáneas:

Cree unha instantánea do seu VPS existente
Crear un novo VPS no lugar de destino
Restaurar a instantánea no novo VPS
Actualizar os rexistros DNS para apuntar a un novo IP
Borrar o antigo VPS unha vez verificada a migración

Nota: A migración a un novo lugar dará como resultado un novo enderezo IP. Planifique o tempo de propagación do DNS (normalmente 24- 48 horas para unha propagación global completa).

Despliegue en varios lugares

Para unha alta dispoñibilidade e alcance global, considere a posibilidade de implantar en varios lugares:

Casos de uso

Entrega global de contido
Equilibrio xeográfico de carga
Recuperación ante desastres
Cumprimento das leis de residencia de datos
Redución da latencia para usuarios internacionais

Implementación

Equilibrio de carga baseado en DNS (GeoDNS)
Integración de CDN (Cloudflare, etc.)
Replicación de bases de datos entre rexións
Solucións de almacenamento compartido
Failover a nivel de aplicación

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

VPS.org API