IP 方案的開發者 API

一個小型 REST API，提供 JSON 回應：無需密鑰即可讀取方案、國家和精確價格，並使用您的 API 密鑰檢查餘額和購買方案。每個回應都有 ok: true 或 false。

基礎 URL: 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
  }
}

新訂單開始時為處理中，當服務準備好時會變為有效；此時訪問會包含登入碼（應用程式方案）、代理列表和用戶（代理方案）或遠端桌面地址（雲端電腦）。每隔幾秒輪詢 GET /orders/{id}，直到它變更。

錯誤

HTTP	錯誤	含義
400	bad_plan, bad_qty, bad_days, bad_country	請求在收費前會進行檢查。
401	unauthorized	發送標頭 Authorization: Bearer pwk_...
402	funds	餘額低於價格；回應包含 need，即缺少的金額。不會進行任何收費。
429	rate_limited	一分鐘內一個金鑰的請求超過 300 次。
503	network	目前無法設定服務；不會進行任何收費。請稍後再試。

在控制台的 API 下建立或替換您的金鑰。金鑰只會顯示一次並僅以雜湊值儲存；替換金鑰會立即停用舊金鑰。