VPS.org API Documentation

Ξεκινώντας

Το API VPS.org σάς επιτρέπει να διαχειρίζεστε μέσω προγραμματισμού όλες τις πτυχές της υποδομής φιλοξενίας VPS, συμπεριλαμβανομένων των διακομιστών, των τομέων, των εγγραφών DNS, των αντιγράφων ασφαλείας και των στιγμιότυπων.

Πιστοποίηση

Όλα τα αιτήματα API απαιτούν έλεγχο ταυτότητας χρησιμοποιώντας ένα διακριτικό φορέα. Μπορείτε να δημιουργήσετε το διακριτικό API σας από τις ρυθμίσεις του λογαριασμού σας στη διεύθυνση admin.vps.org/account/developers/.

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 data = await response.json();
console.log(data);

Κάθε μάρκα φέρει τις δικές του άδειες, όπως οι διακομιστές:list ή dns:*. Ένα αίτημα που χρειάζεται άδεια το σύμβολο δεν έχει απορρίπτεται με 403 και ένα πεδίο που απαιτείται_απαιτείται_αποστολή που αναφέρει την άδεια που λείπει. Αναφορά αδειών

Περιορισμός ρυθμού

Authenticated requests are limited to 1,000 per hour per account. Unauthenticated requests are limited to 100 per hour per IP address. A request over the limit receives 429 with a Retry-After header giving the number of seconds to wait. No rate limit headers are sent on successful responses.

Παγογωνία

Λίστα τελικών σημείων επιστρέφει ένα αντικείμενο με αριθμό, επόμενο, προηγούμενο και αποτελέσματα, 25 αντικείμενα ανά σελίδα. Περάστε σελίδα για να μετακινήσετε μεταξύ των σελίδων, ή ακολουθήστε την επόμενη URL μέχρι να είναι άκυρη. Η λίστα διακομιστών δέχεται επίσης σελίδα_μέγεθος, έως 100.

{
  "count": 84,
  "next": "https://admin.vps.org/api/v1/backups/?page=2",
  "previous": null,
  "results": [ ... ]
}

Χειρισμός σφαλμάτων

Το API χρησιμοποιεί τυπικούς κωδικούς κατάστασης HTTP για να υποδείξει την επιτυχία ή την αποτυχία:

Τα σώματα λάθους είναι JSON. Οι περισσότεροι έχουν ένα πεδίο λεπτομέρειας ή ένα πεδίο σφάλματος, μερικές φορές με ένα μήνυμα? σφάλματα επικύρωσης παρατίθενται τα προβλήματα με όνομα πεδίου.

Κατηγορίες API

Περιηγηθείτε στην τεκμηρίωση του API μας ανά κατηγορία:

Περισσότερα Εντοία

Το API έχει επίσης τελικά σημεία για τις εφαρμογές (/api/v1/decude-configs/ και /api/v1/αναθεωρήσεις/).

Χρειάζεστε βοήθεια;

Εάν έχετε ερωτήσεις ή χρειάζεστε βοήθεια με το API, μη διστάσετε να επικοινωνήσετε μαζί μας:

• Εισιτήρια υποστήριξης: Άνοιγμα αιτήματος υποστήριξης
• E-mail: hello@vps.org
• Documentation: Πλήρης τεκμηρίωση