IPプラン向け開発者API

JSON応答のシンプルなREST API：キーなしでプラン、国、正確な価格を読み取り、APIキーでクレジットを確認しプランを購入できます。すべての応答にok: trueまたはfalseが含まれます。

ベースURL: https://proxyworld.cc/api/v1
認証: Authorization: Bearer pwk_...
形式: JSON over HTTPS
制限: キーごとに1分あたり300リクエスト

エンドポイント

メソッド	パス	キー	機能
GET	/plans	不要	30日あたりの単価、数量割引、最小/最大数量、利用可能国を含む全プラン。
GET	/countries	不要	地域回線、都市、クラウド利用可否を含む24カ国。
GET	/price?plan=rotate-max&quantity=2&days=90	不要	プラン、数量、期間（30、90、180、360日）の正確な合計金額。
GET	/balance	必要	米ドル建てのアカウントクレジット残高。
POST	/orders	必要	クレジットからプランを購入。本文：plan、quantity、days、country（必要なプラン向け）。
GET	/orders	必要	ステータスとアクセス詳細を含む直近100件の注文。
GET	/orders/{id}	必要	コード（PO-...）指定の注文1件。

例

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に変化します。アクセス情報にはログインコード（アプリプラン）、プロキシリストとユーザー（プロキシプラン）、リモートデスクトップアドレス（クラウドPC）が含まれます。activeになるまで数秒ごとにGET /orders/{id}をポーリングしてください。

エラー

HTTP	エラー	意味
400	bad_plan, bad_qty, bad_days, bad_country	請求前にリクエストがチェックされます。
401	unauthorized	Authorization: Bearer pwk_... ヘッダーを送信してください。
402	funds	クレジットが価格より少ないです。不足額がneedとして返答されます。請求は発生しません。
429	rate_limited	1つのキーで1分間に300回以上のリクエスト。
503	network	現在サービスを設定できません。請求は発生しません。後ほど再試行してください。

コンソールのAPIでキーを作成または置換してください。キーは一度だけ表示され、ハッシュとしてのみ保存されます。置換すると古いキーは即時無効になります。