VPS.org API

Documentation de l'API REST

API de localisation

Retrieve information about available datacenter locations for VPS deployment.

Points d'extrémité 1 endpoint
Chemin de base /api/v1/locations
OBTENIR /api/v1/locations/

Liste de tous les emplacements

Récupérer une liste de tous les emplacements de datacenter disponibles où vous pouvez déployer des serveurs VPS.

Paramètres de requête

Paramètre Taper Requis Désignation des marchandises
region string Numéro Filter by region: north-america, europe, asia, oceania
available boolean Numéro Show only locations currently accepting new servers

Exemple de requête

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

Exemple de réponse

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

Champs de réponse

Champ Taper Désignation des marchandises
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

Codes d'état de réponse

200 Liste des emplacements récupérés avec succès
401 Non autorisé - Jeton d'authentification invalide ou manquant

Choosing the Right Location

Par public cible

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

Selon les exigences de conformité

Performance du réseau

Latence la plus faible pour les grands marchés
  • Amérique du Nord : New York (2 m à l'est des États-Unis), San Francisco (2 m à l'ouest des États-Unis)
  • Europe: Francfort (3 ms), Londres (5 ms)
  • Asie: Singapour (5 ms), Tokyo (8 ms)
  • Océanie: Sydney (seulement option)
Le meilleur pour la distribution mondiale
  1. Primaire: New York ou San Francisco (la plus grande base d'utilisateurs)
  2. Secondaire: Londres ou Francfort (couverture européenne)
  3. Tertiaire Singapour ou Tokyo (couverture Asie)
Conseil pro : Pour les applications critiques pour la mission, déployez-vous sur plusieurs sites avec une panne automatique pour un temps d'arrêt maximum et une redondance géographique.

Infrastructure du centre de données

Caractéristiques standard (tous les emplacements)

  • ✓ Centre de données de niveau III ou supérieur
  • ✓ 100 % temps de disponibilité SLA
  • ✓ Puissance redondante (N+1 ou 2N)
  • ✓ Refroidissement redondant
  • ✓ Sécurité physique 24/7
  • ✓ Contrôles d'accès biométriques
  • ✓ Protection DDoS (jusqu'à 10 Tbps d'atténuation)
  • ✓ Prise en charge IPv4 et IPv6
  • ✓ Réseautage privé (VLAN)
  • ✓ 10 Gbps+ colonne vertébrale réseau
  • ✓ Fournisseurs multiples en amont
  • ✓ BGP peering avec les grands réseaux

Fournisseurs de réseaux

Lieu Fournisseur Niveau Remarques
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

Déplacement d'un lieu à l'autre

Vous pouvez migrer votre VPS vers un autre emplacement en utilisant des snapshots :

  1. Créez un instantané de votre VPS existant
  2. Créer un nouveau VPS dans l'emplacement de la cible
  3. Restaurer l'instantané vers le nouveau VPS
  4. Mettre à jour les enregistrements DNS pour pointer vers une nouvelle IP
  5. Supprimer l'ancien VPS une fois la migration vérifiée
Remarque: La migration vers un nouvel emplacement entraînera une nouvelle adresse IP. Planifiez le temps de propagation DNS (généralement 24-48 heures pour la propagation globale complète).

Déploiement à plusieurs emplacements

Pour une grande disponibilité et une portée mondiale élevée, envisagez de vous déployer en plusieurs endroits :

Cas d'utilisation
  • Livraison de contenu mondial
  • Équilibre des charges géographiques
  • Reprise après sinistre
  • Respect des lois sur la résidence des données
  • Réduction de la latence pour les utilisateurs internationaux
Mise en œuvre
  • Équilibrage des charges fondé sur le DNS (GeoDNS)
  • Intégration CDN (Cloudflare, etc.)
  • Réplication de la base de données entre les régions
  • Solutions de stockage partagé
  • Défaillance au niveau de l'application
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.