API ng mga Lokasyon

KUMUHA /api/v1/locations/

Ilista ang Lahat ng Lokasyon

> Bumuo ng isang listahan ng lahat ng mga magagamit na datacenter lokasyon kung saan maaari mong i-deploy VPS server.

Mga Parameter ng Query

Parameter	Uri	Kinakailangan	Paglalarawan
`region`	string	Hindi	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	Hindi	Show only locations currently accepting new servers

Halimbawang Kahilingan

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

Halimbawang Tugon

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

Mga Patlang ng Tugon

Patlang	Uri	Paglalarawan
`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

Mga Kodigo ng Katayuan ng Tugon

200	Matagumpay na nakuha ang listahan ng mga lokasyon
401	Hindi Awtorisado - Hindi wasto o nawawalang token ng pagpapatotoo

Choosing the Right Location

> Ayon sa Target Audience

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

> Sa pamamagitan ng mga Pangangailangan ng Compliance

GDPR (EU Proteksyon ng Data): London, Frankfurt
> US Data ng paninirahan: New York, San Francisco
> Canadian Data Soberanya: Toronto
> APAC Data Residency: Singapore, Tokyo, Sydney

> Network Pagganap

> Pinakamababang latency sa mga pangunahing merkado

Hilagang Amerika: > New York (2ms sa US East), San Francisco (2ms sa US West)
Europa: > Frankfurt (3ms), London (5ms)
Asya > Singapore (5ms), Tokyo (8ms)
Oceania > Sydney (opsyon lamang)

> Pinakamahusay para sa Global Distribution

Pangunahing: > New York o San Francisco (pinakamalaking user base)
Pang-sekundarya: > London o Frankfurt (pagkakaloob ng serbisyo sa Europa)
Tertiary: > Singapore o Tokyo (Asia coverage)

Tip: Para sa mga mission-critical na aplikasyon, i-deploy sa maraming mga lokasyon na may awtomatikong failover para sa maximum na uptime at heograpikal na redundansya.

> Datacenter Infrastructure

> Standard na mga tampok (Lahat ng mga lokasyon)

✓ > Tier III o mas mataas na datacenters
✓ > 100% uptime SLA
✓ > Walang silbi kapangyarihan (N + 1 o 2N)
✓ > Walang kabuluhan paglamig
✓ > 24/7 pisikal na seguridad
✓ Biometric access controls

✓ > DDoS proteksyon (hanggang sa 10 Tbps pagpapagaan)
✓ Suporta sa IPv4 at IPv6
✓ > Pribadong networking (VLAN)
✓ > 10 Gbps + network backbone
✓ > Maraming upstream provider
✓ > BGP peering sa mga pangunahing network

Mga Network Provider

Lokasyon	Tagapagbigay	Mga hayop	Mga tala
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

> Paglipat sa Pagitan ng mga lokasyon

> Maaari mong ilipat ang iyong VPS sa isang iba’t ibang lokasyon gamit ang snapshots:

> Lumikha ng isang snapshot ng iyong umiiral na VPS
> Lumikha ng isang bagong VPS sa target na lokasyon
> Ibalik ang snapshot sa bagong VPS
> I-update ang mga talaan ng DNS upang tumutok sa bagong IP
> I-Delete lumang VPS sa sandaling migrasyon ay na-verify

Tandaan: > Migrating sa isang bagong lokasyon ay magreresulta sa isang bagong IP address. Plano para sa DNS pagpapalaganap ng oras (karaniwang 24-48 oras para sa buong global na pagpapalaganap).

Multi-Location Pag-deploy

Para sa mataas na availability at global na maabot, isaalang-alang ang pagpapatupad sa maraming mga lokasyon:

> Gamitin ang mga kaso

> Global na paghahatid ng nilalaman
> Heograpikal na pag-load balancing
> Disaster recovery
> Pagtupad sa mga batas sa data na residency
> Nabawasan latency para sa mga internasyonal na mga gumagamit

Pagpapatupad

> DNS-based na pag-load balancing (GeoDNS)
> CDN pagsasama (Cloudflare, atbp.)
> Database replication sa buong rehiyon
> Ibahagi ang mga solusyon sa imbakan
> Application-level failover

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

VPS.org API