Developer API para sa mga IP plan

Isang maliit na REST API na may JSON na sagot: basahin ang mga plan, bansa at eksaktong presyo nang walang key, at i-check ang credit at bumili ng mga plan gamit ang iyong API key. Bawat sagot ay may ok: true o false.

Base URL: https://proxyworld.cc/api/v1
Authentication: Authorization: Bearer pwk_...
Format: JSON over HTTPS
Limit: 300 request bawat minuto bawat key

Endpoints

Method	Path	Key	Kung ano ang ginagawa nito
GET	/plans	Hindi	Lahat ng plan na may unit price bawat 30 araw, volume prices, minimum at maximum na quantity at pinapayagang mga bansa.
GET	/countries	Hindi	Ang 24 na bansa na may region line, mga lungsod at cloud availability.
GET	/price?plan=rotate-max&quantity=2&days=90	Hindi	Eksaktong kabuuang halaga para sa isang plan, quantity at period (30, 90, 180 o 360 araw).
GET	/balance	Oo	Credit sa account sa US dollars.
POST	/orders	Oo	Bumili ng plan mula sa credit. Body: plan, quantity, days, country (para sa mga plan na nangangailangan nito).
GET	/orders	Oo	Ang iyong huling 100 na order na may status at access details.
GET	/orders/{id}	Oo	Isang order sa pamamagitan ng code nito (PO-...).

Mga halimbawa

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());

Sagot sa 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
  }
}

Ang isang bagong order ay nagsisimula bilang processing at nagiging active kapag handa na ang service; ang access ay naglalaman ng login code (app plans), proxy list at user (proxy plans) o Remote Desktop addresses (cloud PCs). I-poll ang GET /orders/{id} bawat ilang segundo hanggang sa ito ay magbago.

Mga error

HTTP	error	Kahulugan
400	bad_plan, bad_qty, bad_days, bad_country	Ang request ay sinusuri bago maningil ng kahit ano.
401	unauthorized	Ipadala ang header na Authorization: Bearer pwk_...
402	funds	Ang credit ay mas mababa kaysa sa presyo; ang sagot ay may kasamang need, ang kulang na halaga. Walang sisingilin.
429	rate_limited	Higit sa 300 requests sa isang minuto sa isang key.
503	network	Ang serbisyo ay hindi ma-set up ngayon; walang sisingilin. Subukan ulit mamaya.

Gumawa o palitan ang iyong key sa console sa ilalim ng API. Ang key ay ipapakita minsan at itatago bilang hash lamang; ang pagpapalit nito ay ihihinto agad ang lumang key.