EQVPS
Anza
REST API · MCP

EQVPS API

Jisajili, ongeza salio kwa crypto, na uagize VPS kikamilifu kwa msimbo — bila KYC, bila binadamu katika mzunguko. Imejengwa kwa wasanidi na mawakala wa AI wanaojiandalia seva zao.

OpenAPI 3.1MCP live · 26 toolsBearer authREST + MCP
Base URLhttps://api.eqvps.com/api/v1/eqvps
Jaribu moja kwa mojaSpec ya OpenAPIMarejeleo kamili

Anza haraka

Miito minne: kutoka sifuri hadi VPS inayofanya kazi. Token zilizo hapa chini ni vishika-nafasi — kamwe usibandike token halisi kwenye ukurasa.

# 1. Jisajili — hurejesha Bearer token (bila KYC, bila hatua ya binadamu)
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. Ongeza salio — lipa kwa USDC / USDT / PYUSD, pata 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://…" }   # lipa on-chain, salio hujazwa kiotomatiki
# 3. Agiza VPS — hulipwa kutoka salio (pata slug + os_id kutoka 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. Soma ufikiaji wa SSH — nywila ya root ya mara moja huonyeshwa hapa mara moja
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" } }

Endpoints muhimu

Sehemu ya msingi. Fungua explorer shirikishi kwa kila kigezo na jibu.

POST/auth/registerUnda akaunti na upate Bearer token. Bila nywila, bila hatua ya binadamu.
GET/productsOrodhesha mipango yote ya VPS na spec, bei, na picha za OS zinazotumika.
POST/balance/topupUnda ankara ya kuongeza salio kwa crypto; hurejesha checkout URL. Salio hujazwa baada ya uthibitisho wa on-chain.
POST/ordersAgiza VPS. Hulipa kutoka salio ikiwa lina fedha, vinginevyo hurejesha ankara isiyolipwa.
GET/services/{id}Hali kamili + ufikiaji hai wa SSH. Nywila ya root ya mara moja huonekana hapa mara moja.
GET/balanceSalio la mkopo lililolipiwa awali na sarafu.

Ona kila endpoint, kigezo na schema kwenye explorer shirikishi →

Kwa mawakala wa AI

Wakala anaweza kutoka bila kitu hadi seva inayofanya kazi peke yake — gundua, lipa, andaa, na soma SSH, yote kupitia API au MCP.

MCP iko hai — si iliyopangwa.

Elekeza mteja yeyote wa MCP kwa https://mcp.eqvps.com/mcp (Streamable HTTP). Zana 26 zinashughulikia ugunduzi, akaunti, malipo na udhibiti kamili wa VPS. Zana za umma: list_plans, register_account, login; kila kingine huchukua Bearer token.

Mtiririko unaojitegemea

1. register_account → pata Bearer token
2. topup_balance → lipa checkout URL kwa USDC/USDT
3. order_vps → andaa kutoka salio
4. get_vps_status → pigia kura hadi iwe active, soma SSH (host, port, command, nywila ya mara moja)

Rasilimali zinazosomeka na mashine

agent.jsonWasifu wa mashine — mipango, endpoints, hali ya MCP.mcp.jsonManifesto ya MCP — URL ya seva na orodha ya zana.llms.txtMwongozo mfupi wa LLM na mfano wa mwanzo-hadi-mwisho.llms-full.txtMarejeleo yaliyopanuliwa ya LLM.openapi.jsonSpesifikesheni ya OpenAPI 3.1 (huendesha explorer).

Hitilafu

Misimbo ya kawaida ya hali ya HTTP. Miili hubeba uga wa message inaposhindwa.

HaliMaana
200 / 201OK — ombi limefaulu / rasilimali imeundwa.
401Bearer token haipo au si sahihi.
403Umethibitishwa, lakini si mmiliki wa rasilimali hii.
404Rasilimali haikupatikana.
409Mgongano wa hali (mfano malipo ya kuongeza salio yasiyolipwa tayari yapo).
422Hitilafu ya uthibitishaji — angalia mwili wa ombi.
429Kikomo cha kasi — pumzika na ujaribu tena.

Vikomo vya kasi

Vitendo nyeti (kuagiza, kuongeza salio, kuweka upya nywila, kusakinisha upya, console) vina kikomo cha kasi kwa kila akaunti. Otomatiki ya kawaida hubaki ndani ya vikomo; kwenye 429, punguza kasi na ujaribu tena.

Anza kujenga sasa

Chukua spec, fungua explorer, au soma marejeleo kamili ya masimulizi na usanidi wa MCP.

Fungua explorerSoma nyaraka