Байршлын API

VPS-ийг байршуулах боломжтой газруудын жагсаалтыг харуулна. Сервер үүсгэх үед байршлын id-г location_id болгон өгнө үү.

Төгсгөлийн цэгүүд 2 endpoints

Суурийн зам /api/v1/locations

АВАХ /api/v1/locations/

Бүх байршлыг жагсаах

VPS серверийг байршуулах боломжтой бүх мэдээллийн төвийн байршлын жагсаалтыг олж авна.

Жишээ хүсэлт

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": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 1,
      "name": "New Jersey",
      "country_name": "United States",
      "country_code": "US",
      "is_active": true
    }
  ]
}

Хариултын талбарууд

Газар	Төрөл	Тодорхойлолт
`id`	integer	Газрын тодорхойлолт. Серверийг үүсгэх үед location_id гэж ашиглана.
`name`	string	Хүний уншигдах байршлын нэр
`country_name`	string	Газарзүйн байршил
`country_code`	string	ISO 3166- 1 alpha-2 улсуудын код, том үсэг
`is_active`	boolean	Газар шинэ серверүүдийг хүлээн авах эсэх

Хариу үйлдлийн төлөвийн кодууд

200	Байршлын жагсаалтыг амжилттай авлаа
403	API-ийн түлхүүр алга, эсвэл хүчингүй, эсвэл түлхүүр нь шаардлагатай эрхийг агуулаагүй

АВАХ /api/v1/locations/{id}/

Газарзүйн байршил

Нэг байршлыг id- ээр нь олж авна. Хариулт нь дээрх талбаруудтай нэг байршлын объект болно.

curl -X GET "https://admin.vps.org/api/v1/locations/1/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "id": 1,
  "name": "New Jersey",
  "country_name": "United States",
  "country_code": "US",
  "is_active": true
}

Таны серверийн байрлал

Бүх VPS.org серверүүд одоогоор IPv4 болон IPv6- ийн тусламжтайгаар дэлхийн хэрэглэгчдэд үйлчилгээ үзүүлдэг Америкийн Нью Жерси мужийн серверт ажилладаг. Идентификаторыг кодлохоос илүүтэй үргэлж байршлын эцсийн цэгүүдийг уншиж, шинэ байршлыг нэмэхэд таны нэгтгэх нь шинэ байршлыг авчирна.

VPS.org API