VPS.org API

เอกสาร REST API

API ตำแหน่งที่ตั้ง

Retrieve information about available datacenter locations for VPS deployment.

จุดสิ้นสุด 1 endpoint
เส้นทางฐาน /api/v1/locations
รับ /api/v1/locations/

แสดงสถานที่ทั้งหมด

เรียกดูรายการของสถานที่ศูนย์ข้อมูลที่คุณสามารถใช้เซิร์ฟเวอร์ VPS ได้

พารามิเตอร์การค้นหา

พารามิเตอร์ พิมพ์ ที่จำเป็น คำอธิบาย
region string ไม่มี Filter by region: north-america, europe, asia, oceania
available boolean ไม่มี Show only locations currently accepting new servers

ตัวอย่างคำขอ

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

ตัวอย่างคำตอบ

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

ช่องตอบกลับ

ช่อง พิมพ์ คำอธิบาย
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

รหัสสถานะการตอบกลับ

200 ดึงรายการสถานที่สำเร็จแล้ว
401 ไม่ได้รับอนุญาต - โทเค็นการตรวจสอบสิทธิ์ไม่ถูกต้องหรือไม่มีอยู่

Choosing the Right Location

ตามกลุ่มเป้าหมาย

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

ตามความต้องการของการปฏิบัติตาม

ประสิทธิภาพของเครือข่ายName

ความล่าช้าต่ำสุดไปยังตลาดหลัก
  • อเมริกาเหนือ: นิวยอร์ก (2 มิลลิวินาทีไปทางตะวันออกของสหรัฐอเมริกา), ซานฟรานซิสโก (2 มิลลิวินาทีไปทางตะวันตกของสหรัฐอเมริกา)
  • ยุโรป: แฟรงค์เฟิร์ต (3 มิลวินาที), ลอนดอน (5 มิลวินาที)
  • เอเชีย: สิงคโปร์ (5 มิลวินาที), โตเกียว (8 มิลวินาที)
  • โอเชียเนีย: ซิดนีย์ (ตัวเลือกเดียว)
ดีที่สุดสำหรับการกระจายทั่วโลก
  1. หลัก: นิวยอร์ก หรือ ซานฟรานซิสโก (ฐานผู้ใช้ที่ใหญ่ที่สุด)
  2. ระดับสอง: ลอนดอนหรือแฟรงค์เฟิร์ต (ยุโรป)
  3. ระดับสาม: ประเทศสิงคโปร์ หรือ โตเกียว (เอเชีย)
ข้อแนะนำ: สำหรับแอพพลิเคชั่นที่สำคัญ จัดตั้งไว้หลายที่ด้วยการฟายโอเวอร์อัตโนมัติ เพื่อเพิ่มเวลาใช้งานและความเสี่ยงทางภูมิศาสตร์

โครงสร้างพื้นฐาน

ตัวเลือกมาตรฐาน (ทุกตำแหน่ง)

  • ✓ ศูนย์ข้อมูลระดับ3หรือสูงกว่า
  • ✓ SLA ระยะเวลาใช้งาน 100%
  • ✓ กำลังไฟฟ้าที่เหลือใช้ (N+1 หรือ 2N)
  • ✓ ความเย็นที่เหลือใช้
  • ✓ รักษาความปลอดภัย 24 ชั่วโมง
  • ✓ ควบคุมการเข้าถึงด้วยชีวภาพ
  • ✓ การป้องกัน DDoS (ลดความเสี่ยงได้ถึง 10 Tbps)
  • ✓ รองรับ IPv4 และ IPv6
  • ✓ เครือข่ายส่วนตัว (VLAN)
  • ✓ เครือข่ายเบ็คบอน 10 Gbps+
  • ✓ ตัวจัดหาข้อมูลหลายตัว
  • ✓ เชื่อมต่อ BGP กับเครือข่ายหลัก

บริการเครือข่าย

สถานที่ ตัวจัดหา สัตว์ ข้อความ
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

ย้ายระหว่างตำแหน่ง

คุณสามารถย้าย VPS ไปยังตำแหน่งอื่นได้โดยใช้ภาพถ่าย:

  1. สร้างภาพถ่ายของ VPS ที่อยู่แล้ว
  2. สร้าง VPS ใหม่ในตำแหน่งเป้าหมาย
  3. เรียกคืนภาพถัดไปไปยัง VPS ใหม่
  4. ปรับปรุงบันทึก DNS เพื่อชี้ไปยัง IP ใหม่
  5. ลบ VPS เก่าเมื่อมีการย้ายข้อมูลแล้ว
ข้อความ: การย้ายไปยังตำแหน่งใหม่จะทำให้เกิดที่อยู่ IP ใหม่ วางแผนเวลาการกระจาย DNS (โดยทั่วไป 24- 48 ชั่วโมง สำหรับกระจายทั่วโลก)

การจัดตั้งหลายตำแหน่ง

สำหรับความสามารถในการใช้งานสูงและความสามารถในการเข้าถึงทั่วโลก ลองพิจารณาการจัดตั้งในหลาย ๆ สถานที่:

กรณีการใช้
  • การจัดส่งเนื้อหาทั่วไป
  • การจัดสรรความจุทางภูมิศาสตร์
  • รีเซ็ตหลังเกิดเหตุ
  • ความปลอดภัยของข้อมูล
  • ลดความล่าช้าสำหรับผู้ใช้ต่างประเทศ
ปรับปรุง
  • การจัดสรรความจุบนพื้นฐานของ DNS (GeoDNS)
  • การรวม CDN (Cloudflare, ฯลฯ)
  • ทำสำเนาฐานข้อมูลระหว่างภูมิภาค
  • วิธีการจัดเก็บข้อมูลร่วมกันName
  • ปรับปรุงระดับโปรแกรม
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.