VPS.org API

Tahirin-kevitra REST API

API momba ny toerana

Retrieve information about available datacenter locations for VPS deployment.

Teboka farany 1 endpoint
Lalana fototra /api/v1/locations
ALAO /api/v1/locations/

Tanisao ny toerana rehetra

Maka ny lisitr'ireo toerana misy ny foibe angon-drakitra izay azonao ampiasaina amin'ny mpizara VPS.

Paramètres de requête

Mpizahaky ny macro Karazana ilaina Fanoritsoritana
region string Tsy misy Filter by region: north-america, europe, asia, oceania
available boolean Tsy misy Show only locations currently accepting new servers

Ohatra amin'ny fangatahana

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

Ohatra amin'ny Valiny

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

Saha Valiny

Field Karazana Fanoritsoritana
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

Kaody momba ny satan'ny valiny

200 Voaray soa aman-tsara ny lisitry ny toerana
401 Tsy nahazoana alalana - Tsy manan-kery na tsy ampy ny mari-pamantarana fanamarinana

Choosing the Right Location

Araka ny mpihaino iantefana

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

Araka ny fepetra takiana

Ny fahaizan'ny rezo

Latency ambany indrindra ho an'ny tsena lehibe
  • Amerika Avaratra: New York (2ms mankany Atsinanana), San Francisco (2ms mankany Andrefana)
  • Eoropa: Frankfurt (3ms), London (5ms)
  • Azia: Singapaoro (5ms), Tokyo (8ms)
  • Oceania: Sydney (safidy tokana)
Tsara indrindra ho an'ny fizarana manerantany
  1. Voalohany: New York na San Francisco (toerana misy mpisera be indrindra)
  2. Faharoa: Londona na Frankfurt (fanapariahana ny any Eoropa)
  3. Faharoa: Singapore na Tokyo (fanapariahana ny Azia)
Torohevitra: Ho an'ny fampiharana ny asa-dehibe, ny fametrahana amin'ny toerana maro miaraka amin'ny failover mandeha ho azy ho an'ny fotoana avo indrindra sy ny fihenjanana jeografika.

Fotodrafitrasa

Toetoetra tsotra (toerana rehetra)

  • ✓ Datacenters amin'ny ambaratonga III na ambony kokoa
  • ✓ SLA 100% uptime
  • ✓ Herinaratra tsy ilaina (N+1 na 2N)
  • ✓ Fafana tsy ilaina
  • ✓ Fiarovana ara-batana 24/7
  • ✓ Fifehezana ny fahazoana mampiasa ny biometrika
  • ✓ Fiarovana DDoS (hatramin'ny 10 Tbps)
  • ✓ Fandraisana an-tànana ny IPv4 sy ny IPv6
  • ✓ Rezo manokana (VLAN)
  • ✓ 10 Gbps+ backbone tambajotra
  • ✓ Mpanome marobe
  • ✓ Fifandraisana BGP amin'ny tambajotra lehibe

Mpanome tolotra rezo

Toerana Mpanome tolotra Taona Fanamarihana
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

Fifindran'ny toerana

Afaka manova toerana ny VPS-nao amin'ny alalan'ny sary mihetsika ianao:

  1. Hamorona sary an-tsary ny VPS misy anao
  2. Hamorona VPS vaovao anatin'ilay toerana iantefana
  3. Avereno amin'ny VPS vaovao ilay sary madinika
  4. Manavao ny rakitry ny DNS mba hipetaka amin'ny IP vaovao
  5. Fafao ny VPS taloha rehefa voamarina ny fifindra-monina
Fanamarihana: Ny fifindra-monina mankany amin'ny toerana vaovao dia hiteraka adiresy IP vaovao. Andraso ny fotoana fampielezana DNS (24-48 ora raha ny mahazatra raha ny fampielezana manerantany).

Fampidirana toerana maro

Raha te-hahazo fahafahana avo lenta sy hahatratra ny tontolo, dia eritrereto ny fametrahana azy amin'ny toerana maro:

Fomba fampiasana
  • Fandefasana votoaty manerantany
  • Famaritana ny fandefasana
  • Fandraisana an-tànana ny loza
  • Fanentanana momba ny lalàna momba ny fipetrahana
  • Nihena ny fotoana fiandry ho an'ny mpampiasa iraisam-pirenena
Fampiharana
  • Fampifanaraka ny vesatry ny rakitra mifototra amin'ny DNS (GeoDNS)
  • CDN fampidirana (Cloudflare, sns)
  • Fandraisana andraikitra
  • Fomba fitahirizana iombonana
  • Failover amin'ny rindran'asa
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.