VPS.org API

REST API დოკუმენტაცია

მდებარეობების 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 სერვერი ამჟამად მუშაობს ჩვენს New Jersey, USA მდებარეობაში, რომელიც მომსახურებას უწევს მომხმარებლებს მსოფლიოს მასშტაბით IPv4 და IPv6- ზე. ყოველთვის წაიკითხეთ მდებარეობის დასასრული, ვიდრე ID- ს მყარი კოდირება, ასე რომ თქვენი ინტეგრაცია აიღებს ახალ ადგილებს, როდესაც ისინი დაემატა.