VPS.org API

REST API ҳужжатлаштириш

Joylashuvlar APIsi

VPS ўрнатишингиз мумкин бўлган жойлар рўйхатини кўрсатинг. Сервер яратилганда жойнинг id'ини location_id сифатида ўтказинг.

Tugash nuqtalari 2 endpoints
Asosiy yo'l /api/v1/locations
OLING /api/v1/locations/

Barcha joylarni ro'yxatlash

VPS серверларини ўрнатишингиз мумкин бўлган барча мавжуд маълумотлар маркази манзиллари рўйхатини олиш.

Namunaviy so'rov

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

Javob namunasi

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 1,
      "name": "New Jersey",
      "country_name": "United States",
      "country_code": "US",
      "is_active": true
    }
  ]
}

Javob maydonlari

Асосий Turi Тасвирлаш
id integer Манзил идентификатори. Сервер яратилганда location_id сифатида ишлатинг.
name string Одам ўқий оладиган жой номи
country_name string Манзил мамлакати
country_code string ISO 3166-1 alpha-2 мамлакат коди, катта ҳарфлар
is_active boolean Манзил янги серверларни қабул қилмоқдами ёки йўқми

Javob holati kodlari

200 Joylashuvlar ro'yxati muvaffaqiyatli olindi
403 API токен йўқ ёки нодуруст, ёки токенда талаб қилинган рухсат йўқ
OLING /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 орқали бутун дунё мижозларига хизмат кўрсатади. Ҳар доим ID кодини қаттиқ кодлаш ўрнига манзилнинг охирини ўқинг, шунинг учун интеграциянгиз янги жойлар қўшилганда уларни қабул қилади.