MCP istemcisine ihtiyacım var mı?

Hayır. Bu, HTTPS üzerinden düz REST'tir — curl'den, herhangi bir dilden ya da HTTP konuşan bir ajandan kullanılabilir. MCP kullanırsan, aynı eylemler araç olarak sunulur (bağlanma rehberine bak).

Kimlik doğrulama nasıl çalışır?

Bir Bearer token almak için /auth/register çağır (parola yok). Onu her kimlik doğrulamalı çağrıda Authorization: Bearer başlığı olarak gönder. /products herkese açıktır.

/balance/topup üzerinden ön ödemeli bir bakiye yükle (bir kripto ödeme URL'si döndürür; USDC/USDT ile öde). order ardından bakiyeden düşer. Yüklü değilse, order sana /invoices/{id}/pay üzerinden ödediğin bir fatura döndürür.

Sipariş yanıtı ne içerir?

Ya bir servis id'si ile paid_from_balance (sağlama başladı) ya da ödenecek bir fatura. status active olana dek GET /services/{id} yokla, sonra SSH sunucusunu, portu ve tek seferlik bir root parolasını oku.

4 API çağrısında bir VPS sipariş et (ajanlar için REST hızlı başlangıç)

EQVPS'i sürmek için bir MCP istemcisine ihtiyacın yok — REST API bir ajanın ihtiyaç duyduğu her şeyi yapar. Temel URL: https://api.eqvps.com/api/v1/eqvps. İşte tüm akış, dört çağrıda.

0. (bir kez) Ön ödemeli bir bakiye yükle

Sipariş tek bir çağrı olsun diye önce bir bakiye yükle. Döndürülen ödemeyi USDC/USDT ile öde:

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 ile öde

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

Parola yok, insan adımı yok. Token'ı sakla; onu aşağıda Authorization: Bearer <YOUR_BEARER> olarak gönder.

2. Planları listele → product + os_id seç (herkese açık)

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

Bir plan slug'ı ve o planın available_os'undan bir os_id seç.

3. Bir VPS sipariş et

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..."}'
# → bakiyeden ödendi: { "paid_from_balance": true, "service_id": <id> }
#   ya da yüklü değil:  { "invoice": { "id": <id> } }  → öde: POST /invoices/{id}/pay → checkout_url

Anahtar tabanlı root girişi için bir ssh_key (genel anahtar) geç. Yüklü bir bakiye ile sipariş anında ödenir ve sağlama başlar.

4. Erişimi oku

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": "<anahtarsız sunucular için bir kez gösterilir>" , ... }

status active olana dek yokla. access bloğu SSH sunucusunu, portu ve yapıştırmaya hazır bir command içerir; anahtarsız bir sipariş için tek seferlik root password ilk okumada döndürülür.

Ajanlar için notlar

/products dışındaki her çağrıda Authorization: Bearer <YOUR_BEARER> gönder.
USDC/USDT ile öde (Base, Ethereum, Polygon) — kart gerekmez. Adım 3'ün tek çağrı olması için ön ödemeli bakiyeyi tercih et.
Hassas eylemler (sipariş, parola-sıfırlama, yeniden kurulum, iptal) hız sınırlıdır; normal kullanım sınırların rahatça içindedir.
Ham HTTP yerine araçları mı tercih edersin? Aynı eylemler MCP araçlarıdır — bağlanma rehberine ve araçlar referansına bak. Tam belgeler: /docs.