API ya Maeneo

PATA /api/v1/locations/

Orodhesha Maeneo Yote

Andika orodha ya maeneo yote yaliyopo ya dataenter ambapo unaweza kupata huduma za mtandao wa VPS.

Vigezo vya Hoja

Penseli	Aina	Inahitajika	Maelezo
`region`	string	Hapana	Filter by region: `north-america`, `europe`, `asia`, `oceania`
`available`	boolean	Hapana	Show only locations currently accepting new servers

Ombi la Mfano

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

Jibu la Mfano

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

Sehemu za Majibu

Field	Aina	Maelezo
`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

Misimbo ya Hali ya Majibu

200	Imefanikiwa kurejesha orodha ya maeneo
401	Hairuhusiwi - Tokeni ya uthibitishaji si sahihi au haipo

Choosing the Right Location

Kwa Kulenga Wasikilizaji

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

Napewa Matakwa ya Kuwa na Lengo

GDPR (EU Data Protection): London, Frankfurt
Sheria ya Habari za Marekani: New York, San Francisco
Enzi Kuu ya Data ya Kanada: Toronto
APAC Data Residency: Singapore, Tokyo, Sydney

Utendaji wa Mtandao

Uhaba wa Chini Zaidi kwa Masoko Makubwa

Amerika Kaskazini: New York (2ms to US East), San Francisco (2ms to US West)
Ulaya: Frankfurt (mlo), London (5mu)
Asia: Singapore (miili), Tokyo (8mu)
Oceania: Sydney (jambo pekee)

Bora kwa Ugawanyaji wa Tufeni Pote

Msingi: New York au San Francisco (sehemu kubwa ya msingi)
Sekondari: London au Frankfurt (habari za Ulaya)
Tertiary: Singapore au Tokyo (Masimulizi ya Asia)

Dokezo: Kwa ajili ya maombi ya kiupekuzi, tembelea maeneo mbalimbali yaliyo na ugumu wa kudumu kwa muda mrefu zaidi na wa kijiografia.

Mfumo wa Datacenter

Sehemu za Kiwango (Maeneo Yote)

✓ Tier III au data za hali ya juu zaidi
✓ Asilimia 100 ya wakati wa ziada SLA
✓ Nguvu za umeme zisizo na mipaka (N+1 au 2N)
✓ Kupoa Mara Nyingi
✓ 24/7 usalama wa kimwili
✓ Vifaa vya kudhibiti matumizi ya nishati

✓ Ulinzi wa DDS (karibu 10 Kukatwa Migomba)
✓ IPv4 na IPva6 wanamwunga mkono
✓ Vituo vya kibinafsi (VLAN)
✓ 10 Mfumo wa Gbps+
✓ Watoaji wengi wa upande wa juu wa mto
✓ Upimaji - ramani wa BGP ukiwa na mifumo mikubwa

Waandaaji wa Mtandao

Mahali	Mwandalizi	Tier	Marejeo
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

Kuhama Kati ya Mahali

Unaweza kuhamisha mtandao wa VPS kwenye eneo tofauti kwa kupiga picha:

Andaa picha ya VPS yako iliyopo
Fanya mtandao mpya wa VPS mahali unapolengwa
Rudisha picha hiyo kwenye mtandao mpya wa VPS
Rekodi mpya za DNS kuonyesha kitu kipya cha IP
Uhamaji wa VPS mara uthibitishwapo

Angalia: Kuhamia eneo jipya kutatokeza hotuba mpya ya IPP. Mpango kwa ajili ya uenezaji wa DNS (sawa na saa 24 na48 kwa ajili ya uenezaji kamili wa dunia).

Upunguzaji wa Multi-Lacation

Ili kupatikana kwa urahisi na kufika duniani kote, fikiria kusafiri katika maeneo mbalimbali:

Tumia Visa

Upelekaji wa maudhui ya dunia
Gurudumu la mizigo
Kupona kwa msiba
Huku kukiwa na sheria za kupata data
Kupunguzwa kwa watumiaji wa kimataifa

↓ ↓ ↓ ↓ ↓

GOMA yenye kubeba mizigo (GeoDNS)
CD ya kuunganisha (Cloflare, n.k.)
Tishu ya database inayosambaa katika maeneo mbalimbali
Masuluhisho yaliyohifadhiwa
Ukosefu wa matumizi

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

VPS.org API