EQVPS API
راجستر شئ، په crypto بیلانس ډک کړئ او VPS په بشپړه توګه د کوډ له لارې امر کړئ — بې KYC، په حلقه کې بې انسان. د پرمخکوونکو او د هغو AI اجنټانو لپاره جوړ شوی چې خپل سرورونه چمتو کوي.
https://api.eqvps.com/api/v1/eqvpsچټک پیل
څلور کالونه: له صفر څخه یو روان 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ونه
اصلي سطحه. د هر parameter او ځواب لپاره تعاملي explorer خلاص کړئ.
/auth/registerیو حساب جوړ کړئ او یو Bearer token ترلاسه کړئ. بې پټنوم، بې انساني ګام./productsټول VPS پلانونه د مشخصاتو، بیې او ملاتړ شوو OS تصویرونو سره فهرست کړئ./balance/topupیو crypto ډکولو انوائس جوړ کړئ؛ یو checkout URL راګرځوي. بیلانس د on-chain تایید سره اعتبار کیږي./ordersVPS امر کړئ. که ډک شوی وي له بیلانس څخه تادیه کوي، که نه یو ناتادیه انوائس راګرځوي./services/{id}بشپړ حالت + ژوندی SSH لاسرسی. د یوځلي root کوډ دلته یو ځل ښکاره کیږي./balanceمخکې-تادیه شوی د اعتبار بیلانس او اسعارو.هر endpoint، parameter او schema په تعاملي explorer کې وګورئ →
د AI اجنټانو لپاره
یو اجنټ کولی شي پخپله له هیڅ څخه یو کاري سرور ته لاړ شي — کشف، تادیه، چمتو کول او SSH لوستل، ټول د API یا MCP له لارې.
MCP ژوندی دی — نه پلان شوی.
هر MCP client په https://mcp.eqvps.com/mcp ونښلوئ (Streamable HTTP). ۲۶ وسیلې کشف، حساب، تادیه او بشپړ د VPS کنټرول پوښي. عامه وسیلې: list_plans، register_account، login؛ نور ټول Bearer token ته اړتیا لري.
خپلواک بهیر
1. register_account → یو Bearer token ترلاسه کړئ
2. topup_balance → د checkout URL په USDC/USDT تادیه کړئ
3. order_vps → له بیلانس څخه چمتو کول
4. get_vps_status → تر فعالیدو پورې یې وګورئ، SSH ولولئ (host، port، کمانډ، یوځلی کوډ)د ماشین-لوستلو وړ سرچینې
تېروتنې
معیاري HTTP status codeونه. 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
حساسې کړنې (امر، د بیلانس ډکول، د کوډ بیا تنظیم، بیا نصب، console) په هر حساب rate-limited دي. عادي اتوماتیک د حدونو دننه پاتې کیږي؛ په 429 کې، سست شئ او بیا هڅه وکړئ.
اوس پرې جوړ کړئ
spec ترلاسه کړئ، explorer خلاص کړئ یا د MCP تنظیم سره بشپړ روایتي حواله ولولئ.