VPS.org API

Documentare API REST

API-ul Locațiilor

Anunţă locaţiile unde puteţi implementa un VPS. Pass id-ul locaţiei ca locaţie_id atunci când creaţi un server.

Puncte finale 2 endpoints
Calea de bază /api/v1/locations
OBŢINE /api/v1/locations/

Listați toate locațiile

Obțineți o listă cu toate locațiile de datacenter disponibile în cazul în care puteți implementa serverele VPS.

Exemplu de solicitare

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

Exemplu de răspuns

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

Câmpuri de răspuns

Câmp Tip Descriere
id integer Identificator locație. Folosește-l ca locație_id atunci când creează un server.
name string Nume locație legibil-uman
country_name string Țara în care se află locația
country_code string Codul de țară alpha-2 ISO 3166-1, mai mare
is_active boolean Dacă locația acceptă servere noi

Coduri de stare a răspunsului

200 Lista locațiilor a fost recuperată cu succes
403 Token API lipsă sau nu este valid, sau tokenul nu este permisul necesar
OBŢINE /api/v1/locations/{id}/

Obține o locație

Reduce o singură locație de id. Răspunsul este un obiect de locație cu câmpurile de mai sus.

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
}

Unde sunt serverele tale

Fiecare server VPS.org funcționează în prezent în locația noastră New Jersey, SUA, care servește clienți în întreaga lume peste IPv4 și IPv6. Citiți întotdeauna locațiile punct de endpoint în loc de a coda un ID, astfel încât integrarea dumneavoastră ia noi locații atunci când acestea sunt adăugate.