EQVPS
REST API · MCP

EQVPS API

დარეგისტრირდით, შეავსეთ კრიპტოთი და შეუკვეთეთ VPS მთლიანად კოდით — KYC-ის, ციკლში ადამიანის გარეშე. შექმნილია developer-ებისა და AI აგენტებისთვის, რომლებიც თავად ამზადებენ სერვერებს.

OpenAPI 3.1MCP live · 26 toolsBearer authREST + MCP
Base URLhttps://api.eqvps.com/api/v1/eqvps
სცადეთ ცოცხლადOpenAPI specსრული მითითება

სწრაფი დაწყება

ოთხი call: ნულიდან გაშვებულ VPS-მდე. ქვემოთ მოცემული token-ები placeholder-ებია — არასოდეს ჩასვათ ნამდვილი 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" } }

ძირითადი endpoint-ები

ძირითადი ზედაპირი. გახსენით ინტერაქტიული explorer ყოველი parameter-ისა და პასუხისთვის.

POST/auth/registerშექმენით ანგარიში და მიიღეთ Bearer token. პაროლის, ადამიანის ნაბიჯის გარეშე.
GET/productsჩამოთვალეთ ყველა VPS ტარიფი სპეციფიკაციებით, ფასითა და მხარდაჭერილი OS images-ით.
POST/balance/topupშექმენით კრიპტო შევსების ინვოისი; აბრუნებს checkout URL-ს. ბალანსი ივსება on-chain დადასტურებაზე.
POST/ordersშეუკვეთეთ VPS. თუ დაფინანსებულია, იხდის ბალანსიდან, თორემ აბრუნებს გადაუხდელ ინვოისს.
GET/services/{id}სრული სტატუსი + ცოცხალი SSH წვდომა. ერთჯერადი root პაროლი აქ ჩნდება ერთხელ.
GET/balanceწინასწარ გადახდილი credit ბალანსი და ვალუტა.

იხილეთ ყველა endpoint, parameter და schema ინტერაქტიულ explorer-ში →

AI აგენტებისთვის

აგენტს შეუძლია თავად გაიაროს ნულიდან გაშვებულ სერვერამდე — აღმოჩენა, გადახდა, 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. Body-ები შეიცავენ 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-ია ანგარიშის მიხედვით. ჩვეულებრივი automation რჩება ლიმიტების ფარგლებში; 429-ზე, შეანელეთ და სცადეთ ხელახლა.

ააგეთ მასზე ახლა

მიიღეთ spec, გახსენით explorer, ან წაიკითხეთ სრული ნარატიული მითითება MCP setup-ით.