ฉันต้องมีไคลเอนต์ MCP ไหม?

ไม่ นี่คือ REST ธรรมดาผ่าน HTTPS — ใช้ได้จาก curl ภาษาใด หรือ agent ที่พูด HTTP หากคุณใช้ MCP การกระทำเดียวกันถูกเปิดเป็นเครื่องมือ (ดูคู่มือเชื่อมต่อ)

auth ทำงานอย่างไร?

เรียก /auth/register เพื่อรับโทเคน Bearer (ไม่มีรหัสผ่าน) ส่งมันเป็นเฮดเดอร์ Authorization: Bearer ในทุกการเรียกที่ยืนยัน /products เป็นสาธารณะ

ฉันจ่ายอย่างไร?

ให้ทุนยอดคงเหลือเติมล่วงหน้าผ่าน /balance/topup (คืน checkout URL คริปโต จ่ายด้วย USDC/USDT) จากนั้น order หักยอดคงเหลือ หากไม่ให้ทุน order คืนใบแจ้งหนี้ที่คุณจ่ายผ่าน /invoices/{id}/pay

การตอบของ order มีอะไร?

อาจเป็น paid_from_balance พร้อม id บริการ (การจัดเตรียมเริ่ม) หรือใบแจ้งหนี้ให้จ่าย poll GET /services/{id} จนกว่าสถานะ active จากนั้นอ่าน SSH host, พอร์ต และรหัสผ่าน root ใช้ครั้งเดียว

สั่งซื้อ VPS ใน 4 การเรียก API (REST quickstart สำหรับ agent)

คุณไม่ต้องการไคลเอนต์ MCP เพื่อขับ EQVPS — REST API ทำทุกอย่างที่ agent ต้องการ Base URL: https://api.eqvps.com/api/v1/eqvps นี่คือขั้นตอนทั้งหมดในสี่การเรียก

0. (ครั้งเดียว) ให้ทุนยอดคงเหลือเติมล่วงหน้า

เพื่อให้การสั่งซื้อเป็นการเรียกเดียว ให้ทุนยอดคงเหลือก่อน จ่ายหน้าชำระเงินที่คืนด้วย 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/..." }  ← จ่ายด้วย USDC/USDT

1. ลงทะเบียน → โทเคน 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": {...} }

ไม่มีรหัสผ่าน ไม่มีขั้นตอนมนุษย์ เก็บโทเคน ส่งมันเป็น 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": true, "service_id": <id> }
#   หรือไม่ให้ทุน:       { "invoice": { "id": <id> } }  → จ่าย: POST /invoices/{id}/pay → checkout_url

ส่ง ssh_key (คีย์สาธารณะ) สำหรับการเข้าสู่ระบบ root ด้วยคีย์ ด้วยยอดคงเหลือที่ให้ทุน คำสั่งซื้อถูกจ่ายทันทีและการจัดเตรียมเริ่ม

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": "<แสดงครั้งเดียวสำหรับเซิร์ฟเวอร์ไม่มีคีย์>" , ... }

poll จนกว่า status เป็น active บล็อก access มี SSH host, พอร์ต และ command พร้อมวาง สำหรับคำสั่งซื้อไม่มีคีย์ รหัสผ่าน root ใช้ครั้งเดียวคืนในการอ่านแรก

หมายเหตุสำหรับ agent

ส่ง Authorization: Bearer <YOUR_BEARER> ในทุกการเรียกยกเว้น /products
จ่ายด้วย USDC/USDT (Base, Ethereum, Tron) — ไม่ต้องใช้บัตร ชอบยอดคงเหลือเติมล่วงหน้าเพื่อให้ขั้นที่ 3 เป็นการเรียกเดียว
การกระทำที่ละเอียดอ่อน (order, reset-password, reinstall, cancel) ถูกจำกัดอัตรา การใช้ปกติอยู่ในขีดจำกัดสบาย
ชอบเครื่องมือมากกว่า HTTP ดิบ? การกระทำเดียวกันเป็นเครื่องมือ MCP — ดูคู่มือเชื่อมต่อและอ้างอิงเครื่องมือ เอกสารเต็ม: /docs