EQVPS
REST API · MCP

EQVPS API

Εγγραφείτε, προσθέστε υπόλοιπο με crypto και παραγγείλτε VPS εξ ολοκλήρου με κώδικα — χωρίς KYC, χωρίς άνθρωπο στη διαδικασία. Φτιαγμένο για developers και για AI πράκτορες που παρέχουν τους δικούς τους servers.

OpenAPI 3.1MCP live · 26 toolsBearer authREST + MCP
Base URLhttps://api.eqvps.com/api/v1/eqvps
Δοκιμάστε το ζωντανάOpenAPI specΠλήρης αναφορά

Quickstart

Τέσσερις κλήσεις: από το μηδέν σε ένα VPS σε λειτουργία. Τα tokens παρακάτω είναι placeholders — μην επικολλάτε ποτέ πραγματικό token σε μια σελίδα.

# 1. Register — returns a Bearer token (no KYC, no human step)
curl -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Agent","email":"agent@example.com"}'
# → { "token": "<YOUR_API_TOKEN>" }
# 2. Top up balance — pay in USDC / USDT / PYUSD, get a checkout URL
curl -X POST https://api.eqvps.com/api/v1/eqvps/balance/topup \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"amount":20}'
# → { "checkout_url": "https://…" }   # pay on-chain, balance credits automatically
# 3. Order a VPS — paid from balance (get slug + os_id from GET /products)
curl -X POST https://api.eqvps.com/api/v1/eqvps/orders \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"product":"micro","os_id":1,"ssh_key":"ssh-ed25519 AAAA…"}'
# 4. Read SSH access — one-time root password is shown once here
curl https://api.eqvps.com/api/v1/eqvps/services/SV-XXXXXX \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"
# → { "status":"active", "ssh": { "host":"…", "port":22, "command":"ssh root@… -p 22" } }

Βασικά endpoints

Η βασική επιφάνεια. Ανοίξτε τον διαδραστικό explorer για κάθε parameter και απόκριση.

POST/auth/registerΔημιουργήστε λογαριασμό και αποκτήστε ένα Bearer token. Χωρίς κωδικό, χωρίς ανθρώπινο βήμα.
GET/productsΚαταχωρήστε όλα τα πακέτα VPS με προδιαγραφές, τιμή και υποστηριζόμενες OS images.
POST/balance/topupΔημιουργήστε ένα τιμολόγιο προσθήκης crypto· επιστρέφει checkout URL. Το υπόλοιπο πιστώνεται με την on-chain επιβεβαίωση.
POST/ordersΠαραγγείλτε VPS. Πληρώνει από το υπόλοιπο αν είναι χρηματοδοτημένο, αλλιώς επιστρέφει απλήρωτο τιμολόγιο.
GET/services/{id}Πλήρης κατάσταση + ζωντανή πρόσβαση SSH. Ο εφάπαξ κωδικός root εμφανίζεται εδώ μία φορά.
GET/balanceΠροπληρωμένο υπόλοιπο πίστωσης και νόμισμα.

Δείτε κάθε endpoint, parameter και schema στον διαδραστικό explorer →

Για AI πράκτορες

Ένας πράκτορας μπορεί να πάει από το τίποτα σε έναν λειτουργικό server μόνος του — ανακάλυψη, πληρωμή, provision και ανάγνωση SSH, όλα μέσω του API ή του MCP.

Το MCP είναι ζωντανό — όχι σχεδιαζόμενο.

Στρέψτε οποιονδήποτε MCP client στο https://mcp.eqvps.com/mcp (Streamable HTTP). 26 tools καλύπτουν discovery, λογαριασμό, πληρωμή και πλήρη έλεγχο VPS. Δημόσια tools: list_plans, register_account, login· όλα τα υπόλοιπα χρειάζονται Bearer token.

Αυτόνομη ροή

1. register_account → αποκτήστε Bearer token
2. topup_balance → πληρώστε το checkout URL με USDC/USDT
3. order_vps → provision από το υπόλοιπο
4. get_vps_status → παρακολουθήστε μέχρι να ενεργοποιηθεί, διαβάστε το SSH (host, port, εντολή, εφάπαξ κωδικός)

Αναγνώσιμοι από μηχανή πόροι

Σφάλματα

Τυπικά HTTP status codes. Τα bodies περιέχουν πεδίο message σε περίπτωση αποτυχίας.

ΚατάστασηΣημασία
200 / 201OK — request succeeded / resource created.
401Missing or invalid Bearer token.
403Authenticated, but not the owner of this resource.
404Resource not found.
409State conflict (e.g. an unpaid top-up already exists).
422Validation error — check the request body.
429Rate limited — back off and retry.

Rate limits

Οι ευαίσθητες ενέργειες (παραγγελία, προσθήκη υπολοίπου, reset κωδικού, επανεγκατάσταση, console) είναι rate-limited ανά λογαριασμό. Ο συνήθης αυτοματισμός παραμένει εντός ορίων· σε 429, επιβραδύνετε και δοκιμάστε ξανά.

Χτίστε πάνω σε αυτό τώρα

Αποκτήστε το spec, ανοίξτε τον explorer ή διαβάστε την πλήρη αφηγηματική αναφορά με το setup του MCP.