د REST API او curl سره د VPS اداره: حالت، بریښنا، بیا نصب، نوي کول

د API له لارې سرور غوښتل یوه غوښتنه ده. دا په په 4 API غوښتنو کې VPS وغواړئ کې تشریح شوې. دا پاڼه د هغې وروسته د هر څه په اړه ده: هغه ورځني کارونه چې تاسو به یې بل ډول په ډشبورډ کې په کلیک کول، د curl کمانډونو په توګه لیکل شوي چې په سکریپټ کې یې ایښودلی شئ.

لاندې هر کمانډ موږ د خپرولو مخکې زموږ په API چلولی، او ځوابونه د بېرته راغلو پایلو لنډې کاپي دي.

چمتووالی

دوه متغیرونه کمانډونه لنډ ساتي:

export API=https://api.eqvps.com/api/v1/eqvps
export EQVPS_TOKEN='paste-your-token-here'

ټوکن له POST /auth/register یا په ډشبورډ کې له Settings → API tokens څخه راځي. که نور خلک هم ماشین کاروي، د shell له تاریخچې یې لرې وساتئ؛ له فایل څخه یې د export EQVPS_TOKEN=$(cat ~/.eqvps_token) سره لوستل بس دي.

خپل سرورونه ومومئ

curl -s $API/services -H "Authorization: Bearer $EQVPS_TOKEN"

هر داخلول د 47HZ7YF په څېر یو id لري. دا د خدمت کوډ دی چې نورې ټولې غوښتنې یې اخلي. بیا د یوه سرور بشپړ انځور:

curl -s $API/services/47HZ7YF -H "Authorization: Bearer $EQVPS_TOKEN"

{ "data": {
    "id": "47HZ7YF", "status": "active", "queued": false,
    "product": { "slug": "nano", "name": "Nano" },
    "specs": { "vcpu": 2, "memory_mb": 1024, "disk_gb": 15 },
    "hostname": "agent-box",
    "vm": { "state": "running", "uptime": 5340 },
    "access": { "method": "ssh", "host": "203.0.113.10", "port": 21521, "user": "root", "nat": true, ... } } }

access درته وایي چې څنګه ننوځئ. په هغه پلان کې چې خپل IPv4 لري پورټ 22 دی؛ په NAT پلان کې ستاسو شخصي لېږدول شوی پورټ دی. دا غوښتنه یوازې لولي، نو په لوپ کې یې پوښتل خوندي دي.

که مو پرته له SSH کیلي غوښتنه کړې وي، د root پټنوم یو ځل ښودل کېږي:

curl -s "$API/services/47HZ7YF?reveal=1" -H "Authorization: Bearer $EQVPS_TOKEN"

ترڅو چې سرور لا پیلېږي، ځواب password_pending وایي او یو ځلي ښودنه نه لګېږي. نیمه دقیقه انتظار وکړئ او بیا وپوښتئ.

بریښنا: start، stop، reboot

curl -s -X POST $API/services/47HZ7YF/power \
  -H "Authorization: Bearer $EQVPS_TOKEN" -H "Content-Type: application/json" \
  -d '{"action": "reboot"}'

action یو له start، stop یا reboot څخه دی. هغه سرور چې لا فعال نه دی (لا جوړېږي، یا د نه ورکړې له امله ځنډول شوی) 409 Service is not active ځواب ورکوي. دا ستاسو د سکریپټ تېروتنه نه ده. لومړی status وګورئ.

معیارونه

curl -s "$API/services/47HZ7YF/metrics?timeframe=day" -H "Authorization: Bearer $EQVPS_TOKEN"

CPU، حافظه، شبکه او ډیسک د وخت لړۍ په توګه. timeframe یو له hour (ډیفالټ)، day، week یا month څخه دی. د هغې cron دندې لپاره ګټور چې کله ډیسک پرله پسې لوییږي خبر مو کړي. د اوسني بلینګ دورې ټرافیک شمېرونکي په سرعت او ټرافیک وګورئ کې دي.

د سرور نوم بدل کړئ

curl -s -X POST $API/services/47HZ7YF/hostname \
  -H "Authorization: Bearer $EQVPS_TOKEN" -H "Content-Type: application/json" \
  -d '{"hostname": "web-01"}'

نوی نوم guest agent د چلېدونکي سیسټم دننه پلي کوي، په Linux کې بیا پیلولو ته اړتیا نشته. که سرور درول شوی وي، یا مو qemu-guest-agent لرې کړی وي، غوښتنه 409 agent_unavailable بېرته ورکوي او هېڅ نه بدلېږي.

OS بیا نصب کړئ

دا ډیسک پاکوي. API تاسو اړ باسي چې د سرور اوسنی hostname په confirm کې ولیکئ، څو د غلط خدمت id لرونکی سکریپټ غلط ماشین پاک نه کړي:

curl -s -X POST $API/services/47HZ7YF/reinstall \
  -H "Authorization: Bearer $EQVPS_TOKEN" -H "Content-Type: application/json" \
  -d '{"os_id": 4, "confirm": "web-01"}'

os_id په GET /products کې ستاسو د پلان له available_os لېست یا د سرور له خپلو جزئیاتو راځي. بیا نصب په شالید کې چلېږي؛ تر هغه GET /services/{id} وپوښتئ چې status بیا active شي.

نوي کول او بیلانس

سرورونه هره میاشت ستاسو له مخکې ورکړل شوي بیلانس نوي کېږي. د دې سرور لپاره د اوږدو مودو بیه لیدلو لپاره:

curl -s $API/services/47HZ7YF/renew-options -H "Authorization: Bearer $EQVPS_TOKEN"

د مخکې ورکولو لپاره، فرض کړئ درې میاشتې، په یوه غوښتنه کې:

curl -s -X POST $API/services/47HZ7YF/renew \
  -H "Authorization: Bearer $EQVPS_TOKEN" -H "Content-Type: application/json" \
  -d '{"months": 3}'

months یو له 1، 3، 6 یا 12 څخه دی، او 12 د کلنۍ بیې په تخفیف سره حسابېږي. ځواب paid_from_balance: true وایي او د پای نوې نېټه ورکوي. که بیلانس مقدار پوره نه کړي، هېڅ نه اخیستل کېږي: تاسو paid_from_balance: false او د هغه بل لپاره یو checkout_url ترلاسه کوئ. کله چې بیلانس ډک شو، POST $API/invoices/{invoice_id}/pay هغه بل له بیلانس ورکوي؛ که لا هم کم وي، همغه ډول checkout_url بېرته ورکوي او هېڅ نه اخلي. د بیلانس کتل او ډکول:

curl -s $API/balance -H "Authorization: Bearer $EQVPS_TOKEN"

curl -s -X POST $API/balance/topup \
  -H "Authorization: Bearer $EQVPS_TOKEN" -H "Content-Type: application/json" \
  -d '{"amount": 25}'

د ډکولو ځواب یو checkout_url لري. دا کریپټو ورکړه ده: د Base، Ethereum یا Polygon په شبکه کې USDT، USDC یا ETH. کله چې ورکړه on-chain تایید شي بیلانس ته ورزیاتېږي. ورکړه یوازینی ګام دی چې سکریپټ یې ستاسو پر ځای نشي کولی، مګر دا چې والټ ولري.

Monero هم کار کوي، خو یوازې د لاسي کتنې سره د بیلانس ډکولو په توګه: تاسو XMR لېږئ، د راکړې ورکړې id سپارئ، او موږ یې له تایید وروسته ورزیاتوو. وګورئ د Monero سره ورکړه.

لغوه کړئ، او نظر بدل کړئ

خوندي لغوه سرور د ورکړل شوې دورې تر پایه چالان ساتي او یوازې یې نه نوي کوي:

curl -s -X POST $API/services/47HZ7YF/cancel \
  -H "Authorization: Bearer $EQVPS_TOKEN" -H "Content-Type: application/json" \
  -d '{"type": "end_of_period", "reason": "moving the project elsewhere"}'

reason اړین دی. څو کلمې بس دي. له نېټې مخکې مو نظر بدل شو؟

curl -s -X POST $API/services/47HZ7YF/cancel/undo -H "Authorization: Bearer $EQVPS_TOKEN"

"type": "immediate" هم شته. دا سرور او معلومات یې سمدستي ړنګوي، "confirm": "<hostname>" ته اړتیا لري او بېرته نشي اخیستل کېدای. مګر دا چې رښتیا همدا غواړئ، end_of_period وکاروئ.

ټوکن ژوندی وساتئ

نوي ټوکنونه په ډیفالټ یو کال ژوند کوي. هر تصدیق شوی ځواب د X-Token-Expires-At سرلیک لري، څو سکریپټ یې وخته پام شي. ټوکن په نوي بدل کړئ:

curl -s -X POST $API/auth/token/refresh -H "Authorization: Bearer $EQVPS_TOKEN"

زوړ ټوکن سمدستي کار پرېږدي، نو مخکې له دې چې بل څه وکړئ نوی وساتئ.

هغه تېروتنې چې د سمبالولو ارزښت لري

دا د سکریپټ پر ځای د AI کلاینټ څخه کوئ؟ همدا کارونه د MCP وسایلو په توګه هم شته — وګورئ څنګه د AI اجنټ د MCP له لارې خپل VPS پخپله ساتي او د API ماخذ. لا سرور نه لرئ؟ یو پلان وټاکئ.