VPS.org API

Documentação da API REST

API de Localizações

Retrieve information about available datacenter locations for VPS deployment.

Pontos finais 1 endpoint
Caminho base /api/v1/locations
PEGAR /api/v1/locations/

Listar todos os locais

Obtenha uma lista de todos os locais de datacenter disponíveis onde você pode implantar servidores VPS.

Parâmetros de consulta

Parâmetro Tipo Obrigatório Descrição
region string Não Filter by region: north-america, europe, asia, oceania
available boolean Não Show only locations currently accepting new servers

Exemplo de solicitação

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 Descrição
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 status de resposta

200 Lista de locais recuperada com sucesso
401 Não autorizado - Token de autenticação inválido ou ausente

Choosing the Right Location

Por Audiência Alvo

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

Em conformidade com os requisitos de conformidade

Desempenho da Rede

A latência mais baixa para os principais mercados
  • América do Norte: Nova Iorque (2ms a Leste dos EUA), São Francisco (2ms a Oeste dos EUA)
  • Europa: Frankfurt (3ms), Londres (5ms)
  • Ásia: Singapura (5ms), Tóquio (8ms)
  • Oceania: Sydney (apenas opção)
Melhor para a distribuição global
  1. Primaria: Nova Iorque ou São Francisco (mais grande base de utilizadores)
  2. Secundária: Londres ou Frankfurt (Cobertura da Europa)
  3. Terciário: Singapura ou Tóquio (Cobertura da Ásia)
Dica favorável: Para aplicações críticas de missão, implante em vários locais com falha automática para o tempo máximo de uptime e redundância geográfica.

Infraestrutura de Centro de Dados

Características padrão (Todos os locais)

  • ✓ Centros de dados de nível III ou superiores
  • ✓ 100% de tempo útil SLA
  • ✓ Potência redundante (N+1 ou 2N)
  • ✓ Refrigeração redundante
  • ✓ Segurança física 24/7
  • ✓ Controlos de acesso biométrico
  • ✓ Protecção DDoS (até 10 Tbps de mitigação)
  • ✓ Suporte IPv4 e IPv6
  • ✓ Rede privada (VLAN)
  • ✓ 10 Gbps+ espinha dorsal da rede
  • ✓ Múltiplos fornecedores a montante
  • ✓ BGP olhando com grandes redes

Fornecedores de Rede

Localização Fornecedor 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

Mover-se entre os locais

Você pode migrar seu VPS para uma localização diferente usando snapshots:

  1. Crie um instantâneo do seu VPS existente
  2. Criar um novo VPS na localização de destino
  3. Restaurar o instantâneo para o novo VPS
  4. Atualize os registros de DNS para apontar para o novo IP
  5. Apagar VPS antigo uma vez verificada a migração
Nota: Migrar para um novo local vai resultar em um novo endereço IP. Planear para o tempo de propagação do DNS (normalmente 24-48 horas para a propagação global completa).

Deslocação multilocação

Para alta disponibilidade e alcance global, considere a implantação em vários locais:

Casos de utilização
  • Entrega global de conteúdos
  • Equilibração da carga geográfica
  • Recuperação de catástrofes
  • Cumprimento das leis de residência de dados
  • Redução da latência para usuários internacionais
Execução
  • Balanço de carga baseado no DNS (GeoDNS)
  • Integração do CDN (Cloudflare, etc.)
  • Replicação da base de dados em regiões
  • Soluções de armazenamento compartilhada
  • Falha do nível de aplicação
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.