IP 요금제 개발자 API

JSON 응답을 제공하는 간단한 REST API예요. 키 없이도 요금제, 국가 및 정확한 가격을 확인할 수 있고, 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	예	크레딧으로 요금제 구매. 본문: plan, quantity, days, country(해당 요금제인 경우).
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
  }
}

새 주문은 처리 중으로 시작되고 서비스가 준비되면 활성화돼요. 그때부터 로그인 코드(앱 플랜), 프록시 목록과 사용자(프록시 플랜), 또는 원격 데스크톱 주소(클라우드 PC)를 사용할 수 있어요. GET /orders/{id}를 몇 초마다 폴링해서 상태가 바뀔 때까지 확인하세요.

오류

HTTP	오류	의미
400	bad_plan, bad_qty, bad_days, bad_country	요청은 요금이 청구되기 전에 확인돼요.
401	unauthorized	헤더에 Authorization: Bearer pwk_...를 포함해 보내세요.
402	funds	크레딧이 가격보다 적어요. 부족한 금액이 필요해요. 아무것도 청구되지 않아요.
429	rate_limited	1분 동안 하나의 키로 300개 이상의 요청을 보내면 안 돼요.
503	network	서비스를 지금 설정할 수 없어요. 요금은 청구되지 않아요. 나중에 다시 시도해 주세요.

콘솔의 API 메뉴에서 키를 생성하거나 교체할 수 있어요. 키는 한 번만 표시되며 해시로만 저장되며, 교체하면 이전 키는 즉시 중지돼요.