VPS.org API

Τεκμηρίωση REST API

API διακομιστών

Διαχειριστείτε τους διακομιστές VPS σας μέσω προγραμματισμού. Δημιουργήστε, διαμορφώστε, ελέγξτε και παρακολουθήστε τους εικονικούς ιδιωτικούς διακομιστές σας.

Τελικά σημεία 9 endpoints
Βασική διαδρομή /api/v1/servers
ΠΑΙΡΝΩ /api/v1/servers/

Λίστα όλων των διακομιστών

Ανακτήστε μια λίστα με όλους τους διακομιστές στον λογαριασμό σας.

Παράμετροι ερωτήματος

Παράμετρος Τύπος Υποχρεούμαι Περιγραφή
status σειρά Οχι Φιλτράρισμα κατά κατάσταση διακομιστή: ενεργό, διακοπμένο, σε αναστολή
location σειρά Οχι Φιλτράρισμα κατά τοποθεσία κέντρου δεδομένων

Παράδειγμα Αιτήματος

cURL
Python
JavaScript
PHP
curl -X GET "https://admin.vps.org/api/v1/servers/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

url = "https://admin.vps.org/api/v1/servers/"
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/servers/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const servers = await response.json();
console.log(servers);
$ch = curl_init('https://admin.vps.org/api/v1/servers/');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$servers = json_decode($response, true);
curl_close($ch);

Παράδειγμα απάντησης

{
  "count": 2,
  "results": [
    {
      "id": 12345,
      "name": "web-server-01",
      "hostname": "web01.example.com",
      "status": "active",
      "ip_address": "203.0.113.10",
      "location": "us-west",
      "plan": {
        "id": 1,
        "name": "Standard VPS",
        "vcpus": 2,
        "memory": 4096,
        "storage": 80
      },
      "os": {
        "id": 5,
        "name": "Ubuntu 22.04 LTS"
      },
      "created_at": "2025-01-10T14:30:00Z",
      "updated_at": "2025-01-15T10:20:00Z"
    },
    {
      "id": 12346,
      "name": "db-server-01",
      "hostname": "db01.example.com",
      "status": "active",
      "ip_address": "203.0.113.11",
      "location": "us-east",
      "plan": {
        "id": 2,
        "name": "Performance VPS",
        "vcpus": 4,
        "memory": 8192,
        "storage": 160
      },
      "os": {
        "id": 3,
        "name": "Debian 12"
      },
      "created_at": "2025-01-12T09:15:00Z",
      "updated_at": "2025-01-16T08:45:00Z"
    }
  ]
}

Κωδικοί κατάστασης απόκρισης

200 Η λίστα διακομιστών ανακτήθηκε με επιτυχία
401 Μη εξουσιοδοτημένο - Μη έγκυρο ή λείπει το διακριτικό API
ΘΕΣΗ /api/v1/servers/

Δημιουργία νέου διακομιστή

Αναπτύξτε έναν νέο διακομιστή VPS με καθορισμένη διαμόρφωση.

Παράμετροι σώματος αιτήματος

Παράμετρος Τύπος Υποχρεούμαι Περιγραφή
name σειρά Ναί Όνομα διακομιστή (αλφαριθμητικό, επιτρέπονται παύλες)
plan_id ακέραιος αριθμός Ναί Αναγνωριστικό του προγράμματος VPS
os_id ακέραιος αριθμός Ναί Αναγνωριστικό του λειτουργικού συστήματος
location σειρά Ναί Κωδικός τοποθεσίας κέντρου δεδομένων
hostname σειρά Οχι Όνομα κεντρικού υπολογιστή διακομιστή (FQDN)
ssh_key_id ακέραιος αριθμός Οχι Αναγνωριστικό κλειδιού SSH για εγκατάσταση
backups_enabled λογικό Οχι Ενεργοποίηση αυτόματων αντιγράφων ασφαλείας (προεπιλογή: false)

Παράδειγμα Αιτήματος

cURL
Python
JavaScript
PHP
curl -X POST "https://admin.vps.org/api/v1/servers/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "web-server-02",
    "plan_id": 1,
    "os_id": 5,
    "location": "us-west",
    "hostname": "web02.example.com",
    "backups_enabled": true
  }'
import requests

url = "https://admin.vps.org/api/v1/servers/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "name": "web-server-02",
    "plan_id": 1,
    "os_id": 5,
    "location": "us-west",
    "hostname": "web02.example.com",
    "backups_enabled": True
}

response = requests.post(url, headers=headers, json=data)
print(response.json())
const response = await fetch('https://admin.vps.org/api/v1/servers/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'web-server-02',
    plan_id: 1,
    os_id: 5,
    location: 'us-west',
    hostname: 'web02.example.com',
    backups_enabled: true
  })
});

const server = await response.json();
console.log(server);
$data = [
    'name' => 'web-server-02',
    'plan_id' => 1,
    'os_id' => 5,
    'location' => 'us-west',
    'hostname' => 'web02.example.com',
    'backups_enabled' => true
];

$ch = curl_init('https://admin.vps.org/api/v1/servers/');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$server = json_decode($response, true);
curl_close($ch);

Παράδειγμα απάντησης

{
  "id": 12347,
  "name": "web-server-02",
  "hostname": "web02.example.com",
  "status": "provisioning",
  "ip_address": null,
  "location": "us-west",
  "plan": {
    "id": 1,
    "name": "Standard VPS",
    "vcpus": 2,
    "memory": 4096,
    "storage": 80
  },
  "os": {
    "id": 5,
    "name": "Ubuntu 22.04 LTS"
  },
  "backups_enabled": true,
  "created_at": "2025-01-16T15:30:00Z",
  "updated_at": "2025-01-16T15:30:00Z",
  "message": "Server is being provisioned. This may take 2-5 minutes."
}

Κωδικοί κατάστασης απόκρισης

201 Ο διακομιστής δημιουργήθηκε με επιτυχία
400 Λανθασμένο αίτημα - Μη έγκυρες παράμετροι
401 Μη εξουσιοδοτημένο - Μη έγκυρο ή λείπει το διακριτικό API
402 Απαιτείται πληρωμή - Ανεπαρκείς πιστώσεις
ΠΑΙΡΝΩ /api/v1/servers/{server_id}/

Λήψη λεπτομερειών διακομιστή

Ανάκτηση λεπτομερών πληροφοριών σχετικά με έναν συγκεκριμένο διακομιστή.

Παράμετροι διαδρομής

Παράμετρος Τύπος Υποχρεούμαι Περιγραφή
server_id ακέραιος αριθμός Ναί Μοναδικό αναγνωριστικό διακομιστή

Παράδειγμα Αιτήματος

cURL
Python
JavaScript
curl -X GET "https://admin.vps.org/api/v1/servers/12345/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

server_id = 12345
url = f"https://admin.vps.org/api/v1/servers/{server_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())
const serverId = 12345;
const response = await fetch(`https://admin.vps.org/api/v1/servers/${serverId}/`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const server = await response.json();
console.log(server);

Παράδειγμα απάντησης

{
  "id": 12345,
  "name": "web-server-01",
  "hostname": "web01.example.com",
  "status": "active",
  "ip_address": "203.0.113.10",
  "ipv6_address": "2001:0db8::1",
  "location": "us-west",
  "plan": {
    "id": 1,
    "name": "Standard VPS",
    "vcpus": 2,
    "memory": 4096,
    "storage": 80,
    "bandwidth": 2048
  },
  "os": {
    "id": 5,
    "name": "Ubuntu 22.04 LTS"
  },
  "backups_enabled": true,
  "resource_usage": {
    "cpu_percent": 23.5,
    "memory_used": 2048,
    "disk_used": 35,
    "bandwidth_used": 450
  },
  "created_at": "2025-01-10T14:30:00Z",
  "updated_at": "2025-01-16T15:45:00Z"
}

Κωδικοί κατάστασης απόκρισης

200 Επιτυχής ανάκτηση των στοιχείων του διακομιστή
401 Μη εξουσιοδοτημένο - Μη έγκυρο ή λείπει το διακριτικό API
404 Δεν βρέθηκε - Ο διακομιστής δεν υπάρχει
ΒΑΖΩ /api/v1/servers/{server_id}/

Διακομιστής ενημέρωσης

Ενημέρωση διαμόρφωσης διακομιστή. Όλα τα πεδία είναι υποχρεωτικά.

Παράμετροι διαδρομής

Parameter Type Required Description
server_id integer Yes Μοναδικό αναγνωριστικό διακομιστή

Παράμετροι σώματος αιτήματος

Παράμετρος Τύπος Υποχρεούμαι Περιγραφή
name σειρά Ναί Όνομα διακομιστή
hostname σειρά Ναί Όνομα κεντρικού υπολογιστή διακομιστή (FQDN)
backups_enabled λογικό Ναί Ενεργοποίηση/απενεργοποίηση αυτόματων αντιγράφων ασφαλείας

Παράδειγμα Αιτήματος

cURL
Python
curl -X PUT "https://admin.vps.org/api/v1/servers/12345/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "web-server-updated",
    "hostname": "web-updated.example.com",
    "backups_enabled": true
  }'
import requests

server_id = 12345
url = f"https://admin.vps.org/api/v1/servers/{server_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "name": "web-server-updated",
    "hostname": "web-updated.example.com",
    "backups_enabled": True
}

response = requests.put(url, headers=headers, json=data)
print(response.json())

Κωδικοί κατάστασης απόκρισης

200 Ο διακομιστής ενημερώθηκε με επιτυχία.
400 Λανθασμένο αίτημα - Μη έγκυρες παράμετροι
404 Δεν βρέθηκε - Ο διακομιστής δεν υπάρχει
ΚΗΛΙΔΑ /api/v1/servers/{server_id}/

Μερική ενημέρωση διακομιστή

Ενημερώστε συγκεκριμένα πεδία διακομιστή. Θα ενημερωθούν μόνο τα παρεχόμενα πεδία.

Παράδειγμα Αιτήματος

cURL
Python
curl -X PATCH "https://admin.vps.org/api/v1/servers/12345/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "new-server-name"
  }'
import requests

server_id = 12345
url = f"https://admin.vps.org/api/v1/servers/{server_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {"name": "new-server-name"}

response = requests.patch(url, headers=headers, json=data)
print(response.json())
ΔΙΑΓΡΑΦΩ /api/v1/servers/{server_id}/

Διαγραφή διακομιστή

Μόνιμη διαγραφή ενός διακομιστή. Αυτή η ενέργεια δεν μπορεί να αναιρεθεί.

Παράδειγμα Αιτήματος

cURL
Python
curl -X DELETE "https://admin.vps.org/api/v1/servers/12345/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

server_id = 12345
url = f"https://admin.vps.org/api/v1/servers/{server_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.delete(url, headers=headers)
print(response.status_code)

Κωδικοί κατάστασης απόκρισης

204 Ο διακομιστής διαγράφηκε με επιτυχία.
404 Δεν βρέθηκε - Ο διακομιστής δεν υπάρχει
ΘΕΣΗ /api/v1/servers/{server_id}/start/

Έναρξη διακομιστή

Ενεργοποιήστε έναν διακοπμένο διακομιστή.

Παράδειγμα Αιτήματος

cURL
Python
JavaScript
curl -X POST "https://admin.vps.org/api/v1/servers/12345/start/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

server_id = 12345
url = f"https://admin.vps.org/api/v1/servers/{server_id}/start/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers)
print(response.json())
const serverId = 12345;
const response = await fetch(`https://admin.vps.org/api/v1/servers/${serverId}/start/`, {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const result = await response.json();
console.log(result);

Παράδειγμα απάντησης

{
  "status": "success",
  "message": "Server is starting",
  "server": {
    "id": 12345,
    "name": "web-server-01",
    "status": "starting"
  }
}

Κωδικοί κατάστασης απόκρισης

200 Η εντολή έναρξης διακομιστή στάλθηκε με επιτυχία
400 Λανθασμένο αίτημα - Ο διακομιστής λειτουργεί ήδη
404 Δεν βρέθηκε - Ο διακομιστής δεν υπάρχει
ΘΕΣΗ /api/v1/servers/{server_id}/stop/

Διακοπή διακομιστή

Τερματίστε με χάρη έναν ενεργό διακομιστή.

Παράδειγμα Αιτήματος

cURL
Python
curl -X POST "https://admin.vps.org/api/v1/servers/12345/stop/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

server_id = 12345
url = f"https://admin.vps.org/api/v1/servers/{server_id}/stop/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers)
print(response.json())

Παράδειγμα απάντησης

{
  "status": "success",
  "message": "Server is stopping",
  "server": {
    "id": 12345,
    "name": "web-server-01",
    "status": "stopping"
  }
}
ΘΕΣΗ /api/v1/servers/{server_id}/reboot/

Επανεκκίνηση διακομιστή

Επανεκκινήστε με χάρη έναν διακομιστή που λειτουργεί.

Παράδειγμα Αιτήματος

cURL
Python
curl -X POST "https://admin.vps.org/api/v1/servers/12345/reboot/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

server_id = 12345
url = f"https://admin.vps.org/api/v1/servers/{server_id}/reboot/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers)
print(response.json())

Παράδειγμα απάντησης

{
  "status": "success",
  "message": "Server is rebooting",
  "server": {
    "id": 12345,
    "name": "web-server-01",
    "status": "rebooting"
  }
}

Κωδικοί κατάστασης απόκρισης

200 Η εντολή επανεκκίνησης διακομιστή στάλθηκε με επιτυχία
400 Λανθασμένο αίτημα - Ο διακομιστής δεν εκτελείται
404 Δεν βρέθηκε - Ο διακομιστής δεν υπάρχει