API Pembangun untuk pelan IP

API REST kecil dengan jawapan JSON: baca pelan, negara dan harga tepat tanpa kunci, dan semak kredit serta beli pelan dengan kunci API anda. Setiap jawapan mempunyai ok: benar atau palsu.

URL Asas: https://proxyworld.cc/api/v1
Pengesahan: Authorization: Bearer pwk_...
Format: JSON over HTTPS
Had: 300 permintaan seminit setiap kunci

Titik Akhir

Kaedah	Laluan	Kunci	Apa yang dilakukannya
GET	/plans	Tidak	Semua pelan dengan harga unit setiap 30 hari, harga pukal, kuantiti minimum dan maksimum serta negara yang dibenarkan.
GET	/countries	Tidak	24 negara dengan talian wilayah, bandar dan ketersediaan awan.
GET	/price?plan=rotate-max&quantity=2&days=90	Tidak	Jumlah tepat untuk pelan, kuantiti dan tempoh (30, 90, 180 atau 360 hari).
GET	/balance	Ya	Kredit dalam akaun dalam dolar AS.
POST	/orders	Ya	Beli pelan daripada kredit. Badan: pelan, kuantiti, hari, negara (untuk pelan yang memerlukannya).
GET	/orders	Ya	100 pesanan terakhir anda dengan status dan butiran akses.
GET	/orders/{id}	Ya	Satu pesanan mengikut kodnya (PO-...).

Contoh

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

Jawapan kepada 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
  }
}

Pesanan baru bermula sebagai pemprosesan dan menjadi aktif apabila perkhidmatan sedia; akses kemudian mengandungi kod log masuk (pelan apl), senarai proksi dan pengguna (pelan proksi) atau alamat Desktop Jauh (PC awan). Poll GET /orders/{id} setiap beberapa saat sehingga ia berubah.

Ralat

HTTP	ralat	Maksud
400	bad_plan, bad_qty, bad_days, bad_country	Permintaan diperiksa sebelum sebarang caj dikenakan.
401	unauthorized	Hantar header Authorization: Bearer pwk_...
402	funds	Saldo lebih rendah daripada harga; jawapan termasuk need, jumlah yang kurang. Tiada caj dikenakan.
429	rate_limited	Lebih daripada 300 permintaan dalam satu minit pada satu kunci.
503	network	Perkhidmatan tidak dapat disediakan sekarang; tiada caj dikenakan. Cuba lagi kemudian.

Buat atau ganti kunci anda dalam konsol di bawah API. Kunci ditunjukkan sekali dan disimpan hanya sebagai hash; menggantikannya akan menghentikan kunci lama dengan segera.