Apakah saya butuh klien MCP?

Tidak. Ini REST biasa lewat HTTPS — dapat dipakai dari curl, bahasa apa pun, atau agen yang berbicara HTTP. Jika Anda memakai MCP, tindakan yang sama diekspos sebagai alat (lihat panduan koneksi).

Bagaimana auth bekerja?

Panggil /auth/register untuk mendapat token Bearer (tanpa kata sandi). Kirim sebagai header Authorization: Bearer pada setiap panggilan terautentikasi. /products bersifat publik.

Bagaimana cara membayar?

Danai saldo prabayar lewat /balance/topup (mengembalikan URL checkout kripto; bayar dalam USDC/USDT). order lalu mendebit saldo. Jika tidak terdanai, order mengembalikan faktur yang Anda bayar lewat /invoices/{id}/pay.

Apa yang berisi respons order?

Entah paid_from_balance dengan service id (penyiapan dimulai), atau faktur untuk dibayar. Periksa GET /services/{id} hingga status active, lalu baca host SSH, port, dan kata sandi root sekali pakai.

Pesan VPS dalam 4 panggilan API (mulai cepat REST untuk agen)

Anda tidak butuh klien MCP untuk menjalankan EQVPS — REST API melakukan segala yang dibutuhkan agen. Base URL: https://api.eqvps.com/api/v1/eqvps. Berikut seluruh alurnya dalam empat panggilan.

0. (sekali) Danai saldo prabayar

Agar pemesanan menjadi satu panggilan, danai saldo dulu. Bayar checkout yang dikembalikan dalam 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/..." }  ← bayar dalam USDC/USDT

1. Daftar → token Bearer

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": {...} }

Tanpa kata sandi, tanpa langkah manusia. Simpan tokennya; kirim sebagai Authorization: Bearer <YOUR_BEARER> di bawah.

2. Daftar paket → pilih product + os_id (publik)

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" }, ... ] }, ... ] }

Pilih slug paket dan os_id dari available_os paket itu.

3. Pesan 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 dari list_plans>,"ssh_key":"ssh-ed25519 AAAA..."}'
# → dibayar dari saldo: { "paid_from_balance": true, "service_id": <id> }
#   atau tidak terdanai: { "invoice": { "id": <id> } }  → bayar: POST /invoices/{id}/pay → checkout_url

Sertakan ssh_key (kunci publik) untuk login root berbasis kunci. Dengan saldo terdanai pesanan dibayar seketika dan penyiapan dimulai.

4. Baca akses

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": "<ditampilkan sekali untuk server tanpa-kunci>" , ... }

Periksa hingga status adalah active. Blok access punya host SSH, port, dan command siap-tempel; untuk pesanan tanpa-kunci password root sekali pakai dikembalikan pada pembacaan pertama.

Catatan untuk agen

Kirim Authorization: Bearer <YOUR_BEARER> pada setiap panggilan kecuali /products.
Bayar dengan USDC/USDT (Base, Ethereum, Polygon) — tanpa perlu kartu. Utamakan saldo prabayar agar langkah 3 menjadi satu panggilan.
Tindakan sensitif (order, reset-password, reinstall, cancel) dibatasi-tarif; pemakaian normal jauh di dalam batas.
Lebih suka alat daripada HTTP mentah? Tindakan yang sama adalah alat MCP — lihat panduan koneksi dan referensi alat. Dokumen lengkap: /docs.