采购基础设施，无需人工介入。

下方的服务描述文件是公开的，无需身份验证。无论从哪种智能体环境出发，它都是最合适的第一次调用——一个 JSON 文档，包含产品列表、付款模式，以及本页记录的所有端点。

curl -s 'https://cryptovpshost.com/.well-known/agent.json' \
  -H 'Accept: application/json' | jq .

接下来：完成身份验证，为余额充值，然后部署服务器——全部由你的智能体完成。

权威的价格与规格矩阵位于服务器上的 /includes/catalogue.php。如需以机器方式访问，请使用 §5 中的端点参考。

当前实现：会话 Cookie + CSRF。与网页端流程完全一致。智能体需在整个会话期间保存 PHPSESSID Cookie 和 _token CSRF 值。

路线图：计划推出 Bearer 令牌端点（POST /api/v1/account），返回 { account_token: "AAAA-BBBB-CCCC-DDDD" }。目前基于会话的 API 无需它即可正常使用。Bearer 上线后，所有会话端点也将支持以 Authorization: Bearer <token> 作为备选的认证方式。

JAR=/tmp/nkv.jar
# 1. get a session + CSRF
CSRF=$(curl -sc $JAR https://cryptovpshost.com/csrf.php | jq -r .csrf)

# 2. create the account (no email verification)
curl -sb $JAR -c $JAR https://cryptovpshost.com/auth-api.php \
  -d "action=signup" \
  -d "email=a$(date +%s)@cryptovpshost.com" \
  -d "password=Sup3rH4rdP4ssword!" \
  -d "password_confirm=Sup3rH4rdP4ssword!" \
  -d "_token=$CSRF" | jq .

# 3. confirm we're logged in
curl -sb $JAR https://cryptovpshost.com/me.php | jq .

1. 为余额充值。POST /topup-api.php，参数为 action=create&amount=100&coin=XMR&_token=<csrf> → 返回 order_ref。
2. 打开发票。GET /pay/<order_ref> 返回包含充值地址、精确金额和可选 memo 的 HTML。若通过程序调用，同样的数据也可从 GET /topup-status.php?ref=<order_ref> 获取。
3. 发送加密货币。在对应的网络上，向 deposit_address 精确发送 deposit_amount。$100 起享赠金（+30%），$1000 时最高为 +70%。赠金在确认后自动入账。
4. 等待确认。轮询 GET /topup-status.php?ref=<order_ref>，直到出现 status=confirmed。simsms 枢纽会向 /network-api/payment_status.php 推送 Webhook——通常需要源链上的 1–3 次确认。
5. 部署服务器。POST /deploy-api.php，参数为 product=vps|dedi&plan=s1|s2|s3|r1|r2|r3&region=par|rek|zrh|otp&os=debian-12&billing=1&root_password=<12+chars>&_token=<csrf>。余额扣款是原子操作。响应中包含 server_id 和新的余额。

curl -sb $JAR -c $JAR https://cryptovpshost.com/deploy-api.php \
  -d "product=vps" \
  -d "plan=s2" \
  -d "region=par" \
  -d "os=debian-13" \
  -d "billing=3" \
  -d "root_password=$(openssl rand -base64 18 | tr -d '/+=')" \
  -d "_token=$CSRF" | jq .

# Insufficient balance? Response includes the deficit:
# { ok:false, error:"insufficient_balance", have:X, need:Y, deficit:Y-X, topup:"/topup" }

所有需要身份验证的端点使用相同的 CSRF 机制：将 _token 放在 POST 请求体中，或将 X-CSRF-Token 放在请求头中。该令牌通过 /csrf.php 获取一次，并在整个会话期间有效。

如果有人需要短暂介入（审批、确认），请向其展示这些 URL——它们会用智能体此前的决定预先填好网页流程，无需重新输入。

• 每个 POST 都需要 CSRF。每个会话只需获取一次 /csrf.php；将该值作为 _token 放入请求体，或放入 X-CSRF-Token 请求头。
• 会话 Cookie 必须持久保存。请使用 cookie jar（curl -b/-c、Python requests.Session() 等）。如果不保存，每次调用都是一个全新的匿名会话。
• 幂等性。余额入账通过 credit_applied=1 保证幂等。使用相同参数重复部署会创建新的服务器——目前尚未按部署键去重。如有需要，请在客户端自行去重。
• Webhook 时延。充值确认由 simsms 枢纽主动推送。BTC 的中位数约 3 分钟（1 次确认），XMR 约 30 秒。请以 5–10 秒的间隔轮询 /topup-status.php。
• 充值限额（由服务端强制执行）：每张发票最低 $30，最高 $10,000。超出该范围的值会返回 ok:false 以及 error:'amount_too_low' 或 'amount_too_high'——请勿依赖客户端校验。赠金档位从 $100 起（+30%），超过 $1000 后封顶于 +70%。
• 服务器 root 密码长度必须为 12–64 个字符。静态存储时采用 AES-256-CBC 加密，只有部署程序（provisioner）可以解密。
• 语言前缀。URL 支持可选的语言前缀（/ru/account、/zh/vps/）。对智能体而言，不带前缀的路径才是规范路径。

智能体调用此 API 时，同一位用户所受的运行规则与人工操作时完全相同。请通读一遍，并把这些约束编码进你的智能体的推理逻辑中：

• /terms-of-service——哪些要求我们会处理、哪些不会（仅限司法命令，并会通知客户）。
• /acceptable-use——你可以运行什么（政策是“只要在某个地方合法就行”）。唯一的红线：不得涉及 CSAM。
• /privacy-notice——我们收集什么（一个邮箱、一个密码哈希、你的余额、你的服务器配置），不收集什么（姓名、地址、设备指纹、分析数据）。
• /abuse-policy——仅针对网络层面的滥用（垃圾邮件、扫描、放大攻击）。不会基于内容暂停服务。

欢迎智能体。我们不区分由人类开设的账户和由自主客户端开设的账户，适用的规则完全相同。

MCP 服务器：计划中。上述 REST 接口已涵盖相同的操作。MCP 端点上线后，将通过 /.well-known/agent.json#mcp 以及 openapi.json 中的 x-mcp-server 扩展对外公布。