REST API · MCP

EQVPS API

Регистрирай се, зареди в crypto и поръчай VPS изцяло чрез код — без KYC, без човек в цикъла. Построено за разработчици и за AI агентите, които провижнират собствените си сървъри.

OpenAPI 3.1MCP live · 26 toolsBearer authREST + MCP

Base URLhttps://api.eqvps.com/api/v1/eqvps

Пробвай live OpenAPI спецификация Пълен справочник

Бърз старт

Четири извиквания: от нула до работещ VPS. Token-ите по-долу са placeholders — никога не поставяй реален 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" } }

Основни endpoints

Core повърхността. Отвори интерактивния explorer за всеки параметър и отговор.

POST/auth/registerСъздай акаунт и вземи Bearer token. Без парола, без ръчна човешка стъпка.

GET/productsИзброй всички VPS планове със спецификации, цени и поддържаните OS образи.

POST/balance/topupСъздай фактура за зареждане в crypto; връща URL за плащане. Балансът се кредитира при on-chain потвърждение.

POST/ordersПоръчай VPS. Плати от баланса, ако е зареден, иначе връща неплатена фактура.

GET/services/{id}Пълен статус + live SSH достъп. Еднократната root парола се показва тук веднъж.

GET/balanceБаланс на предплатен кредит и валута.

Виж всеки endpoint, параметър и schema в интерактивния explorer →

За AI агенти

Агент може да отиде сам от нула до работещ сървър — да открие, плати, провижнира и прочете SSH, всичко през API или MCP.

MCP е live — не предстоящо.

Насочи всеки MCP клиент към https://mcp.eqvps.com/mcp (Streamable HTTP). 26 tools покриват откриване, акаунт, плащане и пълен контрол на VPS. Публични tools: 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 → poll-вай докато active, прочети SSH (host, port, команда, еднократна парола)

Машинно четими ресурси

agent.jsonМашинен профил — планове, endpoints, MCP статус.mcp.jsonMCP manifest — URL на сървъра и списък с tools.llms.txtКратко LLM ръководство с end-to-end пример.llms-full.txtРазширен LLM справочник.openapi.jsonOpenAPI 3.1 спецификация (пусни explorer-а).

Грешки

Стандартни HTTP статус кодове. 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

Чувствителните действия (поръчка, зареждане, ресет на парола, преинсталиране, конзола) са rate-limited на акаунт. Нормалната автоматизация е комфортно в рамките на лимитите; на 429, back off и опитай пак.

Започни да строиш сега

Вземи спецификацията, отвори explorer-а, или прочети пълния наративен справочник с MCP настройката.

Отвори explorer-а Прочети документацията