მჭირდება MCP client?

არა. ეს უბრალო REST-ია HTTPS-ზე — გამოსაყენებელი curl-იდან, ნებისმიერი ენიდან ან აგენტიდან, რომელიც ლაპარაკობს HTTP-ზე. თუ MCP-ს იყენებთ, იგივე მოქმედებები გამოაშკარავებულია როგორც tool-ები (იხილეთ connect გზამკვლევი).

როგორ მუშაობს auth?

გამოიძახეთ /auth/register Bearer token-ის მისაღებად (პაროლის გარეშე). გააგზავნეთ ის როგორც header Authorization: Bearer ყოველ ავთენტიფიცირებულ გამოძახებაზე. /products საჯაროა.

როგორ ვიხდი?

დააფინანსეთ წინასწარ-გადახდილი ბალანსი /balance/topup-ით (აბრუნებს კრიპტო checkout URL-ს; გადაიხადეთ USDC/USDT-ით). order შემდეგ აჭერს ბალანსს. თუ არადაფინანსებულია, order აბრუნებს invoice-ს, რომელსაც იხდით /invoices/{id}/pay-ით.

რას შეიცავს order პასუხი?

ან paid_from_balance service id-ით (უზრუნველყოფა დაიწყო), ან invoice გადასახდელად. Poll-ეთ GET /services/{id}, სანამ status active გახდება, შემდეგ წაიკითხეთ SSH host, port და ერთჯერადი root პაროლი.

შეუკვეთეთ VPS 4 API გამოძახებით (REST quickstart აგენტებისთვის)

არ გჭირდებათ MCP client EQVPS-ის ამართვისთვის — REST API აკეთებს ყველაფერს, რაც აგენტს სჭირდება. Base URL: https://api.eqvps.com/api/v1/eqvps. აი მთელი flow ოთხ გამოძახებაში.

0. (ერთხელ) დააფინანსეთ წინასწარ-გადახდილი ბალანსი

რომ შეკვეთა ერთი გამოძახება იყოს, ჯერ დააფინანსეთ ბალანსი. გადაიხადეთ დაბრუნებული checkout USDC/USDT-ით:

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/balance/topup \
  -H "Authorization: Bearer <YOUR_BEARER>" -H "Content-Type: application/json" \
  -d '{"amount": 25}'
# → { "checkout_url": "https://payram.eqvps.com/..." }  ← pay it in USDC/USDT

1. რეგისტრაცია → Bearer token

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Agent","email":"ada@example.com"}'
# → { "token": "<YOUR_BEARER>", "token_type": "Bearer", "user": {...} }

არავითარი პაროლი, არავითარი ადამიანური ნაბიჯი. შეინახეთ token; გააგზავნეთ ის როგორც Authorization: Bearer <YOUR_BEARER> ქვემოთ.

2. ჩამოთვალეთ ტარიფები → აირჩიეთ product + os_id (საჯარო)

curl -s https://api.eqvps.com/api/v1/eqvps/products
# → { "data": [ { "slug": "<product-slug>", "price": {...},
#       "specs": {...}, "available_os": [ { "id": <os_id>, "name": "Ubuntu 24.04" }, ... ] }, ... ] }

აირჩიეთ ტარიფის slug და os_id იმ ტარიფის available_os-იდან.

3. შეუკვეთეთ VPS

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/orders \
  -H "Authorization: Bearer <YOUR_BEARER>" -H "Content-Type: application/json" \
  -d '{"product":"<product-slug>","os_id":<os_id from list_plans>,"ssh_key":"ssh-ed25519 AAAA..."}'
# → paid from balance: { "paid_from_balance": true, "service_id": <id> }
#   or unfunded:       { "invoice": { "id": <id> } }  → pay: POST /invoices/{id}/pay → checkout_url

გადაეცით ssh_key (public key) key-ზე დაფუძნებული root login-ისთვის. დაფინანსებული ბალანსით შეკვეთა იხდება მყისვე და უზრუნველყოფა იწყება.

4. წაიკითხეთ წვდომა

curl -s https://api.eqvps.com/api/v1/eqvps/services/<service-id> \
  -H "Authorization: Bearer <YOUR_BEARER>"
# → { "status": "active", "access": { "host": "...", "port": 22, "command": "ssh root@..." },
#     "password": "<shown once for keyless servers>" , ... }

Poll-ეთ, სანამ status active გახდება. access ბლოკს აქვს SSH host, port და მზა-ჩასაკვრელი command; keyless შეკვეთისთვის ერთჯერადი root password ბრუნდება პირველ წაკითხვაზე.

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

გააგზავნეთ Authorization: Bearer <YOUR_BEARER> ყოველ გამოძახებაზე /products-ის გარდა.
გადაიხადეთ USDC/USDT-ით (Base, Ethereum, Tron) — ბარათი არ არის საჭირო. უპირატესობა მიანიჭეთ წინასწარ-გადახდილ ბალანსს, რომ ნაბიჯი 3 ერთი გამოძახება იყოს.
მგრძნობიარე მოქმედებები (order, reset-password, reinstall, cancel) rate-limited-ია; ნორმალური გამოყენება ლიმიტების ფარგლებში კარგადაა.
უპირატესობას ანიჭებთ tool-ებს raw HTTP-ს ნაცვლად? იგივე მოქმედებები MCP tool-ებია — იხილეთ connect გზამკვლევი და tools reference. სრული დოკუმენტაცია: /docs.