IP套餐开发者接口

简洁的REST API接口，返回JSON格式数据：无需密钥即可查询套餐、国家及精确价格，使用API密钥可查询余额及购买套餐。所有响应均包含ok: true/false状态标识。

基础地址: https://proxyworld.cc/api/v1
鉴权方式: Authorization: Bearer pwk_...
数据格式: JSON over HTTPS
频率限制: 每个密钥每分钟300次请求

接口端点

请求方法	路径	密钥	功能说明
GET	/plans	否	获取所有套餐的30天单价、批量价格、数量区间及适用国家。
GET	/countries	否	获取24个国家的专线区域、城市节点及云服务可用性。
GET	/price?plan=rotate-max&quantity=2&days=90	否	计算指定套餐、数量及周期（30/90/180/360天）的精确总价。
GET	/balance	是	账户余额（美元）。
POST	/orders	是	使用余额购买套餐。请求体需包含：套餐代码、数量、天数、目标国家（如适用）。
GET	/orders	是	获取最近100笔订单的状态及接入信息。
GET	/orders/{id}	是	通过订单号(PO-...)查询单笔订单。

调用示例

cURL

curl -s https://proxyworld.cc/api/v1/price?plan=static-ip\&quantity=10\&days=30

curl -s -X POST https://proxyworld.cc/api/v1/orders \
  -H "Authorization: Bearer pwk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"plan":"static-ip","quantity":10,"days":30,"country":"DE"}'

Python

import requests
KEY = "pwk_YOUR_KEY"
r = requests.post("https://proxyworld.cc/api/v1/orders",
    headers={"Authorization": f"Bearer {KEY}"},
    json={"plan": "rotate-max", "quantity": 2, "days": 90})
print(r.status_code, r.json())

Node.js

const r = await fetch("https://proxyworld.cc/api/v1/orders", {
  method: "POST",
  headers: { Authorization: "Bearer pwk_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ plan: "cloud-pc-b", quantity: 2, days: 30, country: "NL" }),
});
console.log(r.status, await r.json());

POST /orders响应示例

{
  "ok": true,
  "order": {
    "id": "PO-7KQ2M9XHTA",
    "product": "static",
    "plan": "static-ip",
    "quantity": 10,
    "days": 30,
    "country": "DE",
    "price": "40.20",
    "status": "processing",
    "status_text": "Setting up",
    "created_at": "2026-11-05T09:00:00.000Z",
    "active_at": null,
    "ends_at": null,
    "access": null
  }
}

新订单初始状态为processing，服务就绪后转为active；此时access字段将包含登录凭证（应用套餐）、代理列表及账号（代理套餐）或远程桌面地址（云电脑）。建议每隔数秒轮询GET /orders/{id}直至状态变更。

错误代码

HTTP	错误	含义
400	bad_plan, bad_qty, bad_days, bad_country	系统会在扣费前对请求进行验证。
401	unauthorized	发送请求头 Authorization: Bearer pwk_...
402	funds	账户余额不足；响应中包含need字段显示差额金额。不会产生任何扣费。
429	rate_limited	同一API密钥每分钟请求超过300次。
503	network	当前无法完成服务配置；不会产生扣费。请稍后重试。

在控制台API页面创建或更换密钥。密钥仅显示一次并以哈希形式存储；更换会立即停用旧密钥。